You are here: Foswiki>Tasks Web>Item198 (07 Oct 2009, JanDreyer)Edit Attach

Item198: Introduce marks and styleguides for topics in Foswiki (45min)

Priority: Normal
Current State: Confirmed
Released In:
Target Release:
Applies To: Web Site
Reported By: MartinSeibert
Waiting For: Main.WillNorris
Last Change By: JanDreyer
As a means to improve the content on our website, we deactivated the comment field. That is okay for me. But still conversations and long threats evolve, that make it difficult, to follow the discussion. But there are also other deficiencies in our topics.

That is, why I recommend, that we create a guideline for good content and create marks to show people, what should be changed on a page. The current English TWiki-page has such marks in Wikipedia:

Here are some more resources from Wikipedia, that show, how they deal with this issue:

First suggestions for marks in Foswiki

Topics that should be refactored

Use this template to mark the relevant topic:
Please refactor this page wrench This topic has a lot of unstructured content, that cannot be easily perceived by new readers. Please take some time to reorganize and edit the whole page.

Stubs: Topics that should be enhanced

Use this template to mark the relevant topic:
Please enhance this page wip This topic has too little content. Please help to add more content. As long as it is a stub, we also appreciate keywords and unsorted notes.

Note that Wikipedia adds links to guides. This helps the prospect writer.

-- ArthurClemens - 16 Nov 2008 - 15:32

I suggest not using the word "refactor" (or "factor" and other variants). Although most programmers know by now what is meant by this term, it is not a term in general use and particularly for writing, does not add any additional semantic value over "reorganize" or just "rewrite". -- IsaacLin - 16 Nov 2008 - 17:53

changed "refactor" to "reorganize and edit" as reorganize captures the meaning of refactor better than rewrite (at least in this case)

-- WillNorris - 11 Apr 2009

ItemTemplate edit

Summary Introduce marks and styleguides for topics in Foswiki (45min)
ReportedBy MartinSeibert
SVN Range TWiki-4.2.3, Wed, 06 Aug 2008, build 17396
AppliesTo Web Site
Priority Normal
CurrentState Confirmed
WaitingFor WillNorris
Topic revision: r6 - 07 Oct 2009, JanDreyer
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy