none
authorMikeMannix <MikeMannix>
Fri, 14 Sep 2001 04:11:41 +0000 (04:11 +0000)
committerMikeMannix <MikeMannix>
Fri, 14 Sep 2001 04:11:41 +0000 (04:11 +0000)
TWiki/GoodStyle.mdwn
TWiki/TWikiFAQ.mdwn
TWiki/WebHome.mdwn
TWiki/WikiSyntax.mdwn

index f10924c..71b35f6 100644 (file)
@@ -1,3 +1,5 @@
+# <a name="GoodStyle Collaboration Tips"></a><a name="_GoodStyle Collaboration Tips"></a> GoodStyle Collaboration Tips
+
 - TWiki has very simple **[[text formatting rules|Main/TextFormattingRules]]**. You won't go wrong if you:
   - start each line without spaces
   - separate paragraphs with a blank line
@@ -7,9 +9,11 @@
   - 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 on a [[WikiTopic]]:
-  - separate each follow up with a horizontal rule
-  - add your [[WikiName]] and date at the end
+- 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
 - 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 list "Contributors:" at the end of the page
+  - 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 - <code>**http://etcete.ra/...**</code> - it'll clear to anyone where they're headed on click.
+- 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 international, and an international standard **date format** like 01 Sep 2001 is preferred. A date like 9/1/01, can mean either January or September, depending on the local conventions of the readers. For months, use the first three letters: Jan, Feb, Mar, Apr,...
+- 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,...
 
-- Look at the source when you want to find out how something is formatted: click **More** on the lower toolbar, then checkmark **Raw text format** and click on **[ View revision ]**. A bit of HTML experience can't hurt, but you'll soon see with TWiki how far that is from necessary.
+- Check the source when you want to find out how something is formatted: click <code>**Edit**</code> on the lower toolbar. To see earlier versions, click <code>**More**</code>, then check <code>**Raw text format**</code> and click <code>**View revision**</code>. 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
+-- [[PeterThoeny]] - 13 Sep 2001<br /> -- [[MikeMannix]] - 14 Sep 2001 <br />
index 84a34c8..ac960d5 100644 (file)
@@ -1,6 +1,6 @@
 # <a name="Frequently Asked Questions About"></a> Frequently Asked Questions About %WIKITOOLNAME%
 
-This is a real FAQ, and also a demo of one easily implemented knowledge base solution.
+This is a real FAQ, and also a demo of one easily implemented knowledge base solution. See how it's done, click <code>**[Edit]**</code>.
 
 # <a name="TWiki Installation Error"></a> TWiki Installation Error
 
index 8676555..37bf9f7 100644 (file)
@@ -1,6 +1,6 @@
 <table>
   <tr>
-    <td> Welcome to %WIKITOOLNAME%, a flexible, powerful, and simple Web-based collaboration platform. Use %WIKITOOLNAME% to run a project development space, document management system, knowledge base, or other groupware tool, on an intranet or on the Web. <p>This is the place to learn about it, download it, and try it out for yourself... </p>
+    <td> Welcome to TWiki, a flexible, powerful, and simple Web-based collaboration platform. Use TWiki to run a project development space, a document management system, a knowledge base, or any other groupware tool, on an intranet or on the Web. <p>This is the place to learn about it, download it, and try it out for yourself... </p>
     </td>
     <td width="25"> </td>
     <td width="200"><a href="http://TWiki.org/"><img alt="Powered by TWiki" border="0" height="64" src="http://www.dementia.org/twiki//view/twikilogo3.gif" width="131" /></a><br /> The official TWiki<sup>TM</sup><br />site is <a href="http://twiki.org/" target="_top">http://twiki.org/</a></td>
   - [[GoodStyle]]: Working tips for an open collaboration environment
   - [[TextFormattingRules]]: The complete TWiki shorthand syntax on one page
   - [[TWikiVariables]]: How to easily embed text, graphics, dynamic content
-  - [[FileAttachments]]: Upload files by browser for display or download
+  - [[FileAttachments]]: Use your browser to upload files for distribution or display
   - [[WebChangesAlert]]: Subscribe to email alerts linking to the latest page changes
   - [[TWikiPages]]: Customize, rename, move, or delete TWiki topics
 
-> **_NOTE:_**
->
-> _It's easy to customize these User's Guide pages to fit the features and access settings of your TWiki site._
+> _While installing TWiki, it's easy to customize the User's Guide pages to fit the features and access settings of your TWiki site._
 
 <a name="ReferenceManual"></a>
 
@@ -79,4 +77,4 @@ Site tools include utilities for navigating and keeping up with site activity on
 - TWiki is developed as Free Software under the [[GNU/GPL|Main/GnuGeneralPublicLicense]]
 - Get the current version from [TWiki.org Downloads](http://TWiki.org/download.html)<br /> %TLS%
 
--- [[MikeMannix]] - 13 Sep 2001 <br />
+-- [[MikeMannix]] - 14 Sep 2001 <br />
index ab306f2..aa58c2b 100644 (file)
@@ -1,6 +1,6 @@
-# <a name="TWiki Shorthand, Quickly"></a> TWiki Shorthand, Quickly
+# <a name="Instant TWiki Shorthand"></a> Instant TWiki Shorthand
 
-If you can enter text, send an email, your ready for TWiki. Use some simple, intuitive TWiki shorthand, and you have even more control - instantly!
+If you can enter text, write an email, you're ready for TWiki. Use simple, intuitive TWiki shorthand to get even more control - instantly!
 
 - Separate each **paragraph** with a blank line.