Documentation Proposal: We need a Howto web

Motivation

We need better doc. Many of us have written howtos. A Howto web would be a good place to put them.

Description

Relatively concise how to documents. Target audience can be anyone, although tagging or categorising should be used to help focus the topics.

-- MeredithLesly - 28 Feb 2006

Impact

Documentation

Documentation in progress, before it is merged into the TWiki web.

Implementation

Any comments on how the documentation is written or could be improved

Discussion

No we don't, full stop. -- Did you ever read WhyWebsAreABadIdea?

I'm with you about that we need better HowTos and an easier way to find relevant infos, but creating yet another place (Web) where to look will not help. Better to provide a clean TWikiApplication that can be packaged as e.g. HowToContrib? (compare TipsContrib).

-- FranzJosefSilli - 28 Feb 2006

Actually the proposal can be distilled to "We need a way to group HowTo's to easily find them". Codev and TWiki have a very low signal to noise ratio to be useful.

-- RafaelAlvarez - 28 Feb 2006

Maybe what we need are "virtual" webs.
(whatever they may be ....)

-- AntonAylward - 28 Feb 2006

Grouping HowTos is what I started with CategoryCookbook. Though the issue that a separate web solves is how to constrain the search.

Hmmm. You could do a "search this category" box.

-- CrawfordCurrie - 02 Mar 2006

"Virtual webs" as in "Webs formed by a Search"?

-- RafaelAlvarez - 02 Mar 2006

Rafael brings up the right question, "we need a way to group HowTo's to easily find them". Here is how it is currently organized:

• TWikiFAQ - how-to's for admins
• SupplementalDocuments - additional documents for admins (also linking to selected topics in the Codev webs, such as cookbooks)
• TWikiTipsOfTheDay - tips for users

All three are located in the TWiki web.

So, please help organize the SupplementalDocuments if you want to help make it easier to find how-to content easier.

-- PeterThoeny - 13 Mar 2006