Not only would I be able to append user created examples BUT I'd like to enter my own notes, links to examples on my machine and examples written specifically for my to understand.
Sounds very useful, actually.
But it would need to be easy to use/manage.
Lots of individual files ? One per module, split into sections? One per item?
Perhaps some way to describe a certain item...
commands/userdoc/brl/pixmap/loadpixmap.bbdoc
commands/userdoc/brl/pixmap/tpixmap.window.bbdoc
some kind of integration with the IDE would be nice too...