Forum .LRN Q&A: Response to dotLRN Governance

Collapse
Posted by Jim Lynch on
Hate to keep harping on this point...

but

Where Is The Technical Documentation?

As far as I know, there is nothing so far in the way of docs:

  • no overall dotLRN docs
  • no dotLRN package docs
  • no engineering docs (requirements/design)
  • and no ad_proc doc strings.

OTOH, I -do- understand the situation, that it was necessary to get product into production. However, lack of documentation marginalizes every potential new developer that doesn't happen to be located in the same building where the development is taking place.

If we want to avoid this marginalization of potential new developers, documentation at each level must get into the packages.

Also OTOH, dotLRN is great! I plan on using pieces of it in my jam session community application, when I can finally -learn- about it! (side note, I printed just the dotlrn package alone: seven -hundred- pages! I -really- want docs...)