sailorfe

Portfolio

This is downloadable from Dropbox Paper.

Documentation & Technical Writing

pysweph API documentation

Tools: Sphinx, MyST Markdown, sphinx-autodoc, GitHub Actions

Community fork of pywisseph, Python bindings to the Swiss Ephemeris astronomical library. When the original documentation went offline in 2025, I modernized the Sphinx build infrastructure and authored Diataxis-structured guides for domain experts learning to use a low-level API.

After the original maintainer became unreachable, I forked the project with encouragement from the upstream C library creator. Currently refactoring from CPython to CFFI with NumPy-style docstrings for improved sphinx-autodoc integration.

Key achievements:

Ephem tutorial

Tools: MkDocs, Codeberg Pages, Makefile automation

Tutorial documentation for an ephemeris CLI, structured to guide users from installation through advanced workflows. Assumes domain expertise (astrology/astronomy) but not command-line familiarity. Deployed via Makefile-based CI to Codeberg Pages.

Astrolog configuration tutorial

Tools: Buttondown (newsletter platform)

Introductory tutorial bringing domain experts to a 30-year-old open source CLI tool. Writing this revealed gaps in ecosystem accessibility that led me to build my own tools (Ephem) and eventually fork pyswisseph.

Code

pysweph

Languages: C, Python | Tools: CFFI, Sphinx

Refactoring a 19-year-old CPython wrapper to CFFI for improved maintainability and alignment with upstream C library. Includes comprehensive NumPy-style docstrings and automated API reference generation.

Ephem

Language: Python | Tools: Rich, SQLite3, tomllib, PyYAML

Cross-platform ephemeris CLI with SQLite persistence, Rich terminal UI, and dual configuration systems (TOML/YAML). Full user documentation and installation guides for multiple platforms.

Dotfiles

Languages: Shell, Lua | Tools: GNU Stow, Neovim, tmux

XDG-compliant modular development environment for technical writing and Python development. Multi-host configuration management demonstrating Linux systems administration and automation.

Recent posts

archive