Are there good resources for leading documentation for an existing software product having none?
Posted
by
Ben Rose
on Programmers
See other posts from Programmers
or by Ben Rose
Published on 2011-02-17T23:28:39Z
Indexed on
2011/02/17
23:33 UTC
Read the original article
Hit count: 374
Hello. I'm a software developer at a technology company. I have been tasked with leading the documentation effort for the product I work on, both internal to developers as well as spilling over into facilitating the business side of requirements documentation. This internal product has been around for at least 6 years.
One challenge is that this software application has no form of documentation other than some small, outdated pieces here and there. There are comments in the code, but they are technical and do not convey any over-arching behavior (even on technical side). As a consequence of having little to no documentation, this product is often unnecessarily complex under the covers adding to the challenge.
We are very limited on time that will be given to us to work on documentation.
Another thing about me is that I've displayed some ability in writing/communication around the office, but I'm not coming from any sort of documentation or formal writing background (beyond my academic career).
Please share your advise or recommend resources, book/website/forum/whatever, for helping me come up with a plan with milestones, best practices, task delegation, templates, buy-in, etc. I'm hoping for a resource targeting or giving special mention of introducing good documentation on existing projects where there previously was none.
I would be very grateful for your responses.
Ben
© Programmers or respective owner