3 ms·
This. What bugs me is that often they do have times to answer questions, but not to document the product. And then when the next person is hired and asks the
by click170 12y ago
This.
What bugs me is that often they do have times to answer questions, but not to document the product.
And then when the next person is hired and asks the same questions, they still don't have time to document but do have time to answer questions. And again with the next newhire.
Yes, part of this is my responsibility to document as a new hire. That said, I didn't build the system and it would take me longer to document then the original author or existing senior.
- cs02rm0 12y agoYes... but documentation does fall out of date, so YMMV depending on the product and your hiring rate.
- drdeadringer 12y agoWhat do you think//feel about documentation being in some wiki-type format as a means against falling out of date?
- SyneRyder 12y agoI always thought Derek Sivers covered this well with his Delegate Or Die essay: http://sivers.org/delegate http://sivers.org/delegate If they've got the time to answer the questions, then at least that answer should be documented. Even if they don't have time to document everything, you can at least document the parts that people are actively asking / unsure about, and having a fresh pair of eyes document the system can be helpful (can make the documentation easier to understand for newbies, who are the target audience for documentation usually).
- drdeadringer 12y agoI remember reading this post, and liked the idea.