[wp-docs] Task based documentation

[Morgan Doocy]

I agree that task-based articles are more frequently used. However, it  
is also worth noting that any good reference book on an application  
with a UI will have sections which simply describe the UI and give only  
general overviews on how to use it, and I think we would be remiss to  
exclude that from the Codex. It is also worth noting that task-based  
instructions need to be updated just as much as the more expository  
"tour" articles as the software evolves. It's my opinion that both are  
essential to a reference, even though instructions are the more  
frequently used.

Morgan

On Feb 21, 2005, at 12:31 AM, Matthew Mullenweg wrote:

> Since we have this list back, let me emphasis that the best sort of  
> thing for the codex is *task-based* documentation not structure-based.  
> Task-based docs survive changes in the application better (menu items  
> may move around a lot) and matches more how people use software.
>
> Links:
> http://www.sprez.com/news200110.htm
> http://www.io.com/~hcexres/tcm1603/acchtml/task_analysis.html
> http://www.usabilityfirst.com/glossary/term_704.txl
> http://www.techwr-l.com/techwhirl/archives/9802/techwhirl-9802 
> -00321.html
>
> -- 
> Matt Mullenweg
>  http://photomatt.net | http://wordpress.org
> http://pingomatic.com | http://cnet.com
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs