Memorandum

Date: Wed, 14 Jun 2000 14:00:53 -0700

From:	Eric Armstrong
	eric.armstrong@eng.sun.com Reply-To: unrev-II@egroups.com

To:	unrev2 unrev-II@egroups.com

Subject:

Requirements, 0.9

Version 0.9 of the requirements document is now up at my web site.

http://www.treelight.com/software/bootstrap/requirements.html

Here are the changes to version 0.9

• Reformatting and linking, minor edits.
• Improved the picture of development-document cycles.
• Appended a new paragraph to "Partionable"

Thoughts on Using the Wiki system:

One way of using the Wiki version might be as a comment tool. People would not expect to edit the file directly, but would offer either comments or suggestions, evaluations and selections putting their name in each paragraph.

So I might add this to someone else's document:

[eric] Here are my thoughts....

Here again, we "play DKR" by doing the attribution ourselves instead of having it be automatic. And we indent our additions manually, instead of "replying" to a node and having that happen automatically. But it's a start.

Note this procedure is going to require a very disciplined approach to our commentary. We need to start moving in an IBIS kind of direction. For example, each requirement is, in effect, a "possibility" for the system. So each requirement should see these kinds of additions:

• Evaluations
  (this is brilliant / this is dumb)

• Votes
  (need this right away / need to defer this)

• Rationale
  (functionality needed / hard to add later)

• Comments
  (just some notes)

• Arguments
  (pro/con)

• Questions
  (why? where? when?)

• Additions
  (you forgot this one, dummy...)

• Suggestions
  (I would say it this way...)