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
![](/static/devrant/img/pipeless-devrant-banner-white.png)
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
At 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.
-
Most 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. -
asgs115155yWriting 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 -
If 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.
Its magical:) -
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.
Related Rants
How are your companies doing on writing docs? Is it mandatory/optional? Would you say reading a doc by other team in your company would be enough to understand what their module is doing? Do you write docs per module/file/function? Also please mention main programming language if it's not a secret..
question
docs