Tags:
create new tag
view all tags

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

WhatDoesItAffect: Install, Refactoring, Documentation
AffectedExtensions:  
HaveQuickFixFor:  

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. wink -- 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:

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

Edit | Attach | Watch | Print version | History: r9 < r8 < r7 < r6 < r5 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r9 - 2006-03-13 - RafaelAlvarez
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2026 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.