svn commit: r892091 - in /websites/staging/mahout/trunk/content: ./ developers/how-to-update-the-website.html

[bu...@apache.org]

Author: buildbot
Date: Sun Dec 29 20:52:41 2013
New Revision: 892091

Log:
Staging update by buildbot for mahout

Modified:
    websites/staging/mahout/trunk/content/   (props changed)
    websites/staging/mahout/trunk/content/developers/how-to-update-the-website.html

Propchange: websites/staging/mahout/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sun Dec 29 20:52:41 2013
@@ -1 +1 @@
-1552518
+1554065

Modified: websites/staging/mahout/trunk/content/developers/how-to-update-the-website.html
==============================================================================
--- websites/staging/mahout/trunk/content/developers/how-to-update-the-website.html (original)
+++ websites/staging/mahout/trunk/content/developers/how-to-update-the-website.html Sun Dec 29 20:52:41 2013
@@ -363,14 +363,17 @@
 <li>The site will automatically be exported from svn as soon as its committed</li>
 </ol>
 <p><a name="HowToUpdateTheWebsite-SomeDo'sandDont'sofupdatingthewiki"></a></p>
-<h2 id="some-dos-and-donts-of-updating-the-wiki">Some Do's and Dont's of updating the wiki</h2>
+<h2 id="some-dos-and-donts-of-updating-the-web-site-and-wiki">Some Do's and Dont's of updating the web site and wiki</h2>
 <ol>
-<li>Keep the wiki cleanly formatted. Assume the title is of size h1</li>
-<li>Try to keep a single page for a topic instead of starting multiple one.
+<li>Keep all pages cleanly formatted - this includes using standard formatting for headers etc.</li>
+<li>Try to keep a single page for a topic instead of starting multiple ones.
 If the topics are related, put it under as a child under the similar page.</li>
 <li>Notify the developers of orphaned or broken links.</li>
+</ol>
+<h2 id="additional-hints-for-editing-the-wiki-pages">Additional hints for editing the wiki pages</h2>
+<ol>
 <li>
-<p>Use the page title to link pages so that they get correctly updated by
+<p>When linking wiki pages inside of Confluence make sure to use the page title to link pages so that they get correctly updated by
 when someone changes the title
   eg:</p>
 <p>Correct format
@@ -379,8 +382,6 @@ when someone changes the title
 [Name of the link|http://<path to>/how to update the website.html]</p>
 </li>
 </ol>
-<p>To update the pages, update the wiki directly. Do not change the title of
-top level pages without updating the same on the landing page.</p>
 <p>Note to non-committers: If you fail to edit the wiki pages send us a brief note on the
 mailing list - there have been lots of spamming attempts which forced us to shut down
 anonymous wiki editing.</p>