3 ms·
You are most welcome! I'm glad you found it useful. As you go through this exercise I'm sure you will gain new insights into the process and the API itself. Pl
by vishnugupta 6y ago
You are most welcome! I'm glad you found it useful.
As you go through this exercise I'm sure you will gain new insights into the process and the API itself. Please document them for the benefit of others around you. The way I see it, you are anyway putting all the effort to learn the system, you might as well put in a little bit more effort to document and get your peer's appreciation in return. Also, you will have something concrete to show for all the time and effort you put in over 2-3 weeks, as opposed to just saying "Right I'm now ready to maintain/change this API".
Written communication and specifically documentation is a very under-appreciated skill among software engineers. But it's a great way to make yourself visible among your peers and spread the knowledge of the system.
The software you write will have impact on customers, but they are far removed from you. The documentation you write on the other hand is beneficial to your peers with whom you work and interact every day so this is a good way to be in their good books. They will appreciate and respect you for going the extra distance to spread the knowledge.
Good luck!
- silicon2401 6y agoAbsolutely. I've always been a huge fan of documentation and push for it when I'm at an org that doesn't care much for it. Thankfully my current org, at least my current team for sure, is very pro-documentation, so I'm more than happy to create documentation for everything I learn and give back to our internal community since I've also benefited a lot from others' documentation. I also like your point on visibility a lot. That's something I've only really starting learning about recently at my current org, and you make great points there. Thanks again!