3 ms·

Same here. We had a wiki, only 20% of us maintained the wiki, a manager (a great cloud engineer, but less talented as a strategist) added Backstage, they were t

• jsdwarf 4y ago
  Doesn't backstage offer auto-discovery of docs, ie create docs folder in repo, throw in some markdown files and everything gets picked up? If so, what kind of maintenance was required?
  • nailer 4y ago
    > Create docs folder in repo That part. Typed, properly named code doesn't need 'docs' per se. Documented code like: // Sender public key const spk; // Send tokens function txV(){ .. } Is garbage, and should be replaced with: const sender: PublicKey function sendTokens(){ .. } Code docs themselves are for things like edge cases and complexities, and URLs to bigger explanations. Those were being maintained in the wiki.