moar docs.. pausing to refactor template handling in shell