I had done a kind of framework to manage my Bash functions as packages (cf http://github.com/lolive/shinyshell http://github.com/lolive/shinyshell). Even the do

I had done a kind of framework to manage my Bash functions as packages (cf http://github.com/lolive/shinyshell http://github.com/lolive/shinyshell). Even the documentation of functions and packages was tool-assisted (à la Javadoc). But documenting is a kind of chicken and egg problem. It requires an outsider point of view, that is difficult to have when you are in the developpent phase, and everything is in your mind. Nevertheless i agree that documentation is a key part of the success of a project.