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>
