barebox Documentation

Holger Schurig holgerschurig at gmail.com
Tue May 13 07:01:07 PDT 2014


If wiki and doxygen are not updated, than this is a sign that they
should probably be outphased.

Instead, I'd prefer to have text files in the Documentation/ tree. So
changes to them pass the normal review process.

> Plain text files
> - no links
> - no pictures

If we use some special format for them, e.g. Markdown or *.rst, then
the files can still converted to HTML, and links and images could
still be possible. That would mean that wiki.barebox.org probably goes
away, but that (part) of www.barebox.org is generated from the
*.rst/Markdown files.

I personally would rather change local text files than online some
wiki. Locally, I can use grep, Emacs, python-scripts and so on. On the
wiki, I can just use keyboard and mouse ...



More information about the barebox mailing list