none

1 files changed, 12 insertions, 13 deletions

diff --git a/TWiki/WikiSyntax.mdwn b/TWiki/WikiSyntax.mdwn
index 80896c7d..1e5fffa5 100644
--- a/TWiki/WikiSyntax.mdwn
+++ b/TWiki/WikiSyntax.mdwn
@@ -1,6 +1,6 @@
-# <a name="Instant_TWiki_Shorthand"> Instant TWiki Shorthand </a>
+# <a name="TWikiShorthand_Basics"> TWikiShorthand Basics </a>
 
-If you can enter text, write an email, you're ready for TWiki. Use simple, intuitive TWiki shorthand to get even more control - instantly!
+If you can enter text, you're ready for TWiki. With a few simple, intuitive [[TWikiShorthand]] rules, you'll be able to use plain text to create well-styled postings, instantly. Here's a fast-track guide to shorthand basics...
 
 * Separate each **paragraph** with a blank line.
 
@@ -12,25 +12,26 @@ If you can enter text, write an email, you're ready for TWiki. Use simple, intui
 
 * To link to another Wiki topic, type the [[WikiWord]] for that topic. To link to a Wiki topic in another web, type the name of the web, and a dot, first: <code>Test.%HOMETOPIC%</code>.
 
-* * When entering [[WikiName]] signatures - like, %USERNAME% - include the %MAINWEB% as a prefix, since all TWiki member pages are in the %MAINWEB% web: `Main.YourName`.
+* If you enter a [[WikiWord]] for a topic that doesn't exist, it'll appear highlighted, with question mark at the end, prompting you (or someone else) to start off the new topic by clicking the **?** - [[NewTopic]] (click the **?**, but don't save, to preserve the example!).
 
-* If you enter a [[WikiWord]] for a topic that doesn't exist, it appears highlighted, with a question mark link at the end, prompting you (or someone else) to start off the new topic by clicking the **?** - [[FreshTopic]] (try clicking the **?**, but don't save, or you'll create a <code>**FreshTopic**</code> page and ruin this example).
+* When entering WikiName signatures - like, %USERNAME% - include the %MAINWEB% as a prefix, since all TWiki member pages are in the %MAINWEB% web: `Main.YourName`.
 
-* For an external link, type the full URL: `http://twiki.org` = <http://twiki.org>
+* For an external link, type the full URL: `http://twiki.org`.
 
-* To prevent a [[WikiWord]] from becoming a link, type `<nop>` first, <code>**&lt;nop&gt;WikiWord**</code> = WikiWord
+* To prevent a WikiWord from becoming a link, type `<nop>` first, <code>**&lt;nop&gt;NoLinkPlease**</code>.
 
 * To indent with a bullet, enter `[space][space][space][asterisk][space]`.
   * Use multiples of 3 spaces to start **nested bullets**.
     * That's 3-6-9-...
-  1. Start items in a **numbered list** with `[space][space][space][1][space]`.
-  2. The "1" (or **any number**) will be replaced by the correct number, in order.
 
-* Always start **counting spaces** for bullets and such from the beginning of a new line.
+1. Start items in a **numbered list** with `[space][space][space][1][space]`.
+2. The "1" (or **any number**) will be replaced by the correct number, in order.
+
+* Always start **counting** for bullets and such from the beginning of a new line.
 
 * To include an image, type its URL. You also can Attach an image to the page and display it with text <br />=%ATTACHURL%/yourimagefilename.jpg=.
 
-* To display a word or phrase in `MONOSPACED type`, put it in equal signs: <code>=like this=</code>. <br />Use <code>==two==</code> for bold: <code>**bold mono**</code>.
+* To display a word or phrase in `MONOSPACED TYPE`, put it in equal signs: <code>=like this=</code>. <br />Use <code>==two==</code> for bold: <code>**bold mono**</code>.
 
          Surround code excerpts, filenames, and other
          unformatted text with <pre> or </pre>
@@ -39,8 +40,6 @@ If you can enter text, write an email, you're ready for TWiki. Use simple, intui
 
 * Use three (or more) consecutive **hyphens** expands into a horizontal rule: `---`
 
-* See [[TextFormattingRules]] for more....
+* See [[TWikiShorthand]] for the complete set of formatting rules.
 
 ----
-
--- [[MikeMannix]] - 01 Oct 2001 <br />