doc/documentation: developer,philosophy,user: suggestions by