documentation
Fri, Jun 29, 2018 | applications, documentation, personal, reviews
This is a quick review of Bear Writer, a popular note-taking application that I tried out a few weeks ago. A much larger and more detailed post about my overall quest for a note-taking solution (I have very picky, perhaps contradictory requirements) is forthcoming! The good Bear is a beautiful set of applications. Attractive without being ostentatious or getting in the way, pretty quick/slick to use, desktop and mobile apps clearly resemble each other, etc.



Sun, Sep 29, 2013 | documentation, maintainership, sphinx

Most open source projects store documentation in the source repo itself. This is easy to do, allows the doc builder to reference in-code documentation (like Python docstrings), makes contributions from others simpler, etc.

However, it doesn’t always play nice with “meta” information such as how to contribute, project roadmap, and so forth.