svn commit: r1447684 - /incubator/marmotta/site/trunk/HOWTO.txt

[wi...@apache.org]

Author: wikier
Date: Tue Feb 19 11:41:41 2013
New Revision: 1447684

URL: http://svn.apache.org/r1447684
Log:
improved marmotta's site howto based on the comments by danielsh, plus other minor updates

Modified:
    incubator/marmotta/site/trunk/HOWTO.txt

Modified: incubator/marmotta/site/trunk/HOWTO.txt
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/HOWTO.txt?rev=1447684&r1=1447683&r2=1447684&view=diff
==============================================================================
--- incubator/marmotta/site/trunk/HOWTO.txt (original)
+++ incubator/marmotta/site/trunk/HOWTO.txt Tue Feb 19 11:41:41 2013
@@ -3,16 +3,23 @@ How to update the Marmotta website
 
 INTRO
 -----
-The http://incubator.apache.org/marmotta/ is managed by the ASF CMS
-(http://cms.apache.org).
+The http://marmotta.incubator.apache.org/ is managed by the ASF CMS
+(https://cms.apache.org).
 
 All Marmotta committers have read-write access to the website content,
 but it's good practice to discuss big changes on the dev list in advance.
 
-Content is provided in markdown structured text format, see cms.a.o for
-pointers to syntax and conventions.
+Build is done with the Maven Site Plugin:
+  http://maven.apache.org/plugins/maven-site-plugin/
 
-See also http://wiki.apache.org/general/ApacheCms2010 for help and links.
+Content is provided in APT (Almost Plain Text) structured text format, see: 
+  http://maven.apache.org/doxia/references/apt-format.html
+for pointers to syntax and conventions.
+
+For help see also:
+  http://www.apache.org/dev/cmsref
+  http://www.apache.org/cms
+  http://www.apache.org/cmsadoption
 
 WORKING IN SVN
 --------------
@@ -32,11 +39,18 @@ To push the changes in production, conne
   https://cms.apache.org/marmotta/publish 
 with your LDAP credentials (as set on people.apache.org).
 
+Non-committers could generate anonymous patches via the CMS UI.
+
 BROWSER-BASED EDITING AND PUBLISHING
 ------------------------------------
 Starting at https://cms.apache.org/marmotta/ , one can get a working copy, 
 edit it if needed (with simple preview) and publish it to the live site.
 
+ACKNOWLEDGMENTS
+---------------
+Thanks the Stanbol team, particulary Bertrand Delacretaz AND Rupert 
+Westenthaler, for providing the original content for this brief HowTo.
+
 THAT'S IT
 ---------
 The Apache CMS is a simple tool compared to some of the CMS we're used to.
@@ -44,4 +58,4 @@ The Apache CMS is a simple tool compared
 The nice thing is that the workflow happens in svn, so it's no different
 than what we do for code.
 
-Enjoy.
+Enjoy!