svn commit: r1242592 - /trafficserver/site/trunk/README

[ig...@apache.org]

Author: igalic
Date: Thu Feb  9 23:05:29 2012
New Revision: 1242592

URL: http://svn.apache.org/viewvc?rev=1242592&view=rev
Log:
more instructions. Or rather, less. Maybe. I don't know.

Modified:
    trafficserver/site/trunk/README

Modified: trafficserver/site/trunk/README
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/README?rev=1242592&r1=1242591&r2=1242592&view=diff
==============================================================================
--- trafficserver/site/trunk/README (original)
+++ trafficserver/site/trunk/README Thu Feb  9 23:05:29 2012
@@ -1,3 +1,55 @@
+ Updating the Content
+ ====================
+
+In order to update the site all you have to do is edit the appropriate
+file in the `content/` directory.
+These files are written in Markdown. The syntax is explained best by
+
+  http://daringfireball.net/projects/markdown/syntax
+
+If you want to change a style, those can be found in `content/styles/`
+
+Change the general layout by modifying the files in `templates/`.
+You can also change the behaviour by modifying the files in `lib/`.
+Documentation on this process can be found at
+
+  http://www.apache.org/dev/cms.html
+
+
+ Publishing the Site
+ ===================
+
+Publish your changes happens when you commit.
+They will appear (almost) instantly at
+
+  http://trafficserver.staging.apache.org/
+
+If you are not a committer, simply run
+
+    $ svn diff
+
+and send us that patch to dev@trafficserver.apache.org or file
+an issue in our Jira:
+
+  https://issues.apache.org/jira/browse/TS
+
+
+ Switching the Content `live`
+ ============================
+
+To push the changes to our publicly well-known site, as a commiter
+you can simply login to people.apache.org and run, e.g.:
+
+    $ publish.pl trafficserver igalic
+
+You might want to replace `igalic` with *your* Apache ID.
+
+
+
+For the curious, or those doing heavy modification, sometimes it is
+necessary or beneficial to see the changes locally, before of commiting
+every single change to staging. The following are instructions for
+that case:
 
  Building the Site
  =================