New Documentation for barebox

Holger Schurig holgerschurig at gmail.com
Thu Jun 26 03:11:15 PDT 2014


> No, we would like to clearly separate user docs

But still it is unfortunate that two "Getting Barebox" chapters are
there at all, and that they are very near to each.

Also, I think that (necessarily!) the design desicions are now mostly
in the user manual, e.g. device parameters. In the non-user-manual
parts there is hardly contents at all. And most, e.g. the file system
descriptions or the glossary, could very well be moved into the user
manual. Which will lead us to ... the user-manual containing all of
the current HTML docs.

So, let me rephrase it: I also think that long term the whole current
(!) HTML documentation should be part of the user manual.

Simply because there's no developer documentation in the current (!)
HTML, e.g. "How to start a new board" type docs, or an introduction
into the file system structure.

Maybe the PBL chapter is developer documentation, but that is (sic!)
in the user manual ...



More information about the barebox mailing list