Helping With Technical Documentation

This is why few people volunteer to help with writing documentation:

How to use Sphinx to give an old book new life.

I appreciate that the author is trying to help people. Yet this is a typical article of the technically savvy “preaching to the choir.” Non technical users never will bother with such articles.

If Sphinx is based on Python, then why is there no GUI front-end?

Why should people waste time digging into Yet Another Esoteric Markup Language (reStructedText)?

Why is there no basic What You See Is What You Mean (WYSIWYM) interface? Something similar to Lyx for LaTeX? Or a LibreOffice template?

Helping with documentation often is an area non programmers are urged to help with free/libre software. This is not going to happen as long non technical users lack the tools they need.

Posted: Category: Usability Tagged: Tech Writing

Next: Embrace, Extend, Extinguish

Previous: Designed By Geeks For Geeks