Updated: 10/29/02; 9:57:05 AM.

 Russ Lipton Documents Radio
simplex veri sigillum

daily link  Monday, September 23, 2002

From today's Dive Into Mark:

"For each domain (RSS feeds, FOAF files, whatever), somebody (or some group) needs to come along and document best practices. We need better goal-oriented documentation. We have a lot of reference documentation, task-oriented documentation, but very little that documents that larger picture and answers questions written in English. “How do I include personal information in my RSS feed?” is a goal-oriented question. “Create a FOAF file using this tool and then insert this line at this location in your RSS feed” (with as many examples as necessary) is a goal-oriented answer. Anything less is like trying to master a foreign language by reading a dictionary."

I thought goal-oriented and task-oriented documentation were/are the same?

I think (thought) I am doing goal-oriented documentation but Mark hasn't given me enough help there to know what he means.

(BTW, I am a great admirer of his text on Python which I found one of the clearest texts of its kind ever written).

On another note, my first cut at a Radio book outline is done but I am worrying over it not unlike a dog over a bone. Bad. Bad. Note to self: put it up and get on with it. Or get on with something.


  feedback:   5:07:41 PM  permalink  

September 2002
Sun Mon Tue Wed Thu Fri Sat
1 2 3 4 5 6 7
8 9 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28
29 30          
Aug   Oct

    Powered by PicoSearch
Top 10 hits for goal-oriented documentation on..
1.Russ Lipton Documents Radio
2.Russ Lipton Documents Radio
3.Russ Lipton Documents Radio
4.Russ Lipton Documents Radio
5.Russ Lipton Documents Radio
7.Jonathon Delacour: Trying to score a goal
8.Project perspective on goal - oriented measurement program
9.Goal Oriented Requirements
10.Services: Analysis, Design, Documentation

Help link 10/29/02; 9:56:35 AM.

Subscribe to "Russ Lipton Documents Radio" in Radio UserLand.

Click to see the XML version of this web page.

Click here to send an email to the editor of this weblog.
Click here to visit the Radio UserLand website.


Copyright 2002 © Russ Lipton.
Last update: 10/29/02; 9:57:05 AM.