Welcome, Registration, and other StartingPoints; TWiki history & Wiki style; All the docs...

GoodStyle Collaboration Tips

  • TWiki has very simple text formatting rules. You won't go wrong if you:
    • start each line without spaces
    • separate paragraphs with a blank line

  • Run together capitalized words to make WikiWords:
    • WikiWords automatically appear as hyperlinks
    • make up meaningful Wiki names - it can be a challenge (it'll sharpen you up!)
    • WikiWords has name-creation tips that may help

  • If a discussion is going on:
    • separate each follow-up with a horizontal rule
    • add your WikiName and the date at the end
    • OR, by all means, insert your comment where it seems to fit best:
      • you may want to inset it with a bullet and/or set it in italics so it's clear (always sign and date)

  • A good format for a new topic is "dissertation followed by discussion":
    • start with a brief, factual introduction
    • then bring on the opinions.

  • When a discussion dies down and the page becomes static, feel free to refactor mercilessly:
    • fearlessly edit down to capture the key points
    • reduce the noise without losing the facts or the flavor
    • if you merge or delete comments, you can group credit Contributors: at the end of the page
    • That's how Wiki content matures and grows in value over time.

  • For external site links, you can type URLs directly into the text - http://etcete.ra/... - it'll clear to anyone where they're headed on click.

  • TWiki is intended for world-wide use, and an international standard date format like 01 Sep 2001 is preferred. It's universally understood, and clearer than the xx/xx/xx format, where a date like 9/1/01 can mean either Jan or Sep, depending on the local conventions of the readers. For months, use the first three letters: Jan, Feb, Mar, Apr,...

  • Check the source when you want to find out how something is formatted: click Edit on the lower toolbar. To see earlier versions, click More, then check Raw text format and click View revision. A bit of HTML experience can't hurt, but you'll soon see with TWiki shorthand how far that is from necessary.

-- PeterThoeny - 13 Sep 2001
-- MikeMannix? - 14 Sep 2001

Go

Navigation

Webs Webs

r5 - 14 Sep 2001 - 03:30:29 - MikeMannix?
This site is powered by the TWiki collaboration platform.
All material on this collaboration platform is the property of the contributing authors.
All material marked as authored by Eben Moglen is available under the license terms CC-BY-SA version 4.
Syndicate this site RSSATOM