Programmers Stack Exchange is a question and answer site for professional programmers interested in conceptual questions about software development. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

The "classic" development artifacts are requirements documents and design specifications. But the development process includes many other non-source code artifacts: bug tracking databases, emails, wikis.

What kinds of non-source code artifacts do you think are most vital to your development process? And how do you keep these documents up to date?

Also, are there any artifacts that you don't necessarily find useful, but have to use because it's required by the contractor or management?

share|improve this question

closed as not constructive by Thomas Owens Mar 18 '12 at 14:51

As it currently stands, this question is not a good fit for our Q&A format. We expect answers to be supported by facts, references, or expertise, but this question will likely solicit debate, arguments, polling, or extended discussion. If you feel that this question can be improved and possibly reopened, visit the help center for guidance.If this question can be reworded to fit the rules in the help center, please edit the question.

A heavy "box of shame" that is put on your desk as soon as you break the build. – Job Dec 12 '10 at 17:15
Closed as part of STCI cleanup for the software-engineering tag. Unfortunately, this question is just generating a list of artifacts rather than answering a specific question. – Thomas Owens Mar 18 '12 at 14:52
up vote 2 down vote accepted

Source code edit history

(especially if linked to use case and bug tracker)

share|improve this answer

(UI Mockup) Wireframe and Compositions

Required by contract. In order to qualify, the company needs to hire user-experience (UX), human-computer interaction (HCI), and graphic designers who can furnish those artifacts, and signed off by the DBA, in the first milestone.

share|improve this answer

Use Case

Use Case is most vital for development process. For each new use case we simply update them and relate them to the case number. At the backend there is of course a versioning tool.

share|improve this answer

In my first job out of university, there were two significant non-code artifacts.

  • The payroll reindeer was a little stuffed toy that sat on the desk partition of the person currently responsible for maintenance of the payroll system.

  • The project management tool was a wooden rod, 1/2 inch square and about a foot long.

Nuff said, I think.

share|improve this answer
+0 (neutral): Not enough has been said. Are you really claiming that even a TODO list isn't useful? – Macneil Dec 13 '10 at 0:49
@Macneil - definitely not as important as a payroll reindeer, IMO. – Stephen C Dec 14 '10 at 3:08

Not the answer you're looking for? Browse other questions tagged or ask your own question.