sailorfe

Portfolio

This is downloadable from Dropbox Paper.

Technical Writing and Documentation

Pyswisseph Documentation (Sphinx, MyST Markdown)

Rescued the documentation for a Python library serving thousands of downloads per month. After 16 months of developer absence and multiple open issues about missing documentation, including from the creator of the upstream C library, I rebuilt the docs with Sphinx and MyST, wrote tutorials and conceptual styles following the Diataxis framework, and regenerated the API reference with sphinx-autodoc. The previous documentation was hosted on an expired domain with broken links and outdated RST files, so I deployed a working preview site and opened a comprehensive PR that addresses many outstanding user issues.

Ephem Tutorial (MkDocs) (MkDocs)

I wrote this tutorial for my ephemeris calculator CLI, intended for astrologers generally accustomed to GUIs. It guides users from installation through increasingly advanced calculations that model real astrological practice, assuming domain expertise but not necessarily command-line experience.

Astrolog Tutorial

I wrote this tutorial to introduce domain experts to an open source program that has been actively maintained since 1991, as most astrologers rely on proprietary, Windows-only GUIs. In documenting someone else’s code, I discovered gaps in the broader ecosystem’s accessibility and maintainability, which directly led me to write my own application (Ephem) and contribute documentation to pyswisseph.

Code Projects

Dotfiles (shell)

A modular, XDG-compliant configuration for multi-host technical writing and Python development environment with Neovim and tmux, managed with GNU Stow.

Ephem (Python)

A modern, cross-platform astrology CLI built with SQLite3 persistence and Rich for beautiful, informative output, configured with tomllib and alternatively managed with a YAML database frontend. It serves as an interface to the pyswisseph library.

meow (Python)

A Markdown cat with Rich and Pygments that respects LS_COLOR for terminal enthusiasts and Linux ricers.

Nick Cave Lyric Search (Python)

Contextual search through a hand-compiled dataset with Flask and Gunicorn, deployed using Render. Originally a React app.

synastry (Python)

Relational data visualization with Pandas and matplotlib.

Recent posts