54
votes
11answers
7k views

How should I remember what I was doing and why on a project 3 months back?

I was working on this project 3 months back, and then suddenly another urgent project appeared and I was asked to shift my attention there. Now, from tomorrow I'll be heading back to my old project ...
1
vote
2answers
286 views

When to write software project documentation on code [duplicate]

I usually write my software projects in java, and I am still a bit confused as to when to document my classes, interfaces and methods. There are two ways: 1) Write documentation after declaring or ...
10
votes
5answers
537 views

My manager hates documentation in our large project. What should I do?

I am working in a small team on a large complex software project. I want to document all requirements, but I've been told by my manager that it is waste of time. I have tried the same with design ...
8
votes
5answers
2k views

Why bother differentiating between functional and nonfunctional requirements?

I understand the difference between the two, but I get questioned by my colleagues of the benefit of labeling requirements as functional or nonfunctional (or transitional). Why bother to do so? He ...
19
votes
12answers
849 views

What makes documentation good? [duplicate]

I need to write documentation for several projects I worked on. I was wondering what, according to your experience, makes documentation useful and complete. What part should I include, how deep should ...
4
votes
1answer
209 views

What strategy to use when starting in a new project with no documentation?

Which is the best why to go when there are no documentation? For example how do you learn business rules? I have done the following steps: Since we are using a ORM tool I have printed a copy of ...