Ranter
Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
heartade1344y@devdiddydog This literally, someone with basic coding knowledge would be able to infer how most of stuff works through type annotations and variable names
-
kamen69964yI'd say that well-written TypeScript is almost self-documenting (even without the JSDoc-style comments), but if your manager insists, I think you can check out a tool that goes over your project and extracts the needed info - e.g. tsdoc, api-extractor (haven't tried these myself, got them from a quick search).
-
kamen69964y@heartade You should be able to say "it's documented already" then. Also, an expectation of someone with no programming background maintaining it sounds pretty naïve.
-
heartade1344y@kamen That's the problem actually - the manager has no programming background and they want it in a format they can read. They just won't hear it.
-
Put it full of links to articles explaining each design pattern and trick, I assure you they won't read more than one of them.
-
@heartade It's also a very efficient teaching method, although if you wanted to make it easy for the student you should probably provide a suggested read order. for the components.
I've been asked by my manager to document my TypeScript project with more than a hundred .ts files such that "someone with no programming background should be able to maintain it."
I should get paid as a textbook author.
rant