Do all the things like ++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatarSign Up
Codex4041870714dAt the moment its not allowed. We are struggling to get out the weekly deadlines on time as is. And these deadlines are real deadlines, the company will indeed die if we dont succeed.
Demolishun87014dMost of the code at my work has zero comments and is not documented. I have started adding testing, comments, and limited number of docs. Some event style documentation is going on in our ticket system, but not a whole lot.
Cannot fault them, they have been around 20 years.
asgs568714dWriting docs is not mandatory, but always recommended. And no, reading the docs is NOT enough to get someone new started. We write it per component, not module/file/function
And I don't think programming languages are a secret at all. It will mostly be one or more of the top 15 popular languages in the industry
torpkev29314dWho has time to write docs? (As nice as it would be)
Santaclauze399314dIf we inplement a new feature in the main app we make an introduction with example and any decided implementation standard.
We use an auto component doc generated for our react components.
We comment when code is off standard or if its a hack around.
We peer review and code review every push by 1 dev and 1 lead dev.
Nothing that is vague or of standard goes through.
irene3181214dThere are no docs. Docs are a lie!
For us, as a consultantcy, doing docs seems to be really difficult for us. If you get put onto a client project there might be multiple documents in multiple different places but you have no idea how much there exactly is.
Your Job Suck?
Take a quick quiz from Triplebyte to skip the job search hassles and jump to final interviews at hot tech firms
Get a Better Job