You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mrunit.apache.org by bu...@apache.org on 2012/04/12 15:14:44 UTC
svn commit: r812528 - in /websites/staging/mrunit/trunk/content: ./
mrunit/development/edit_website.html
Author: buildbot
Date: Thu Apr 12 13:14:44 2012
New Revision: 812528
Log:
Staging update by buildbot for mrunit
Modified:
websites/staging/mrunit/trunk/content/ (props changed)
websites/staging/mrunit/trunk/content/mrunit/development/edit_website.html
Propchange: websites/staging/mrunit/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Apr 12 13:14:44 2012
@@ -1 +1 @@
-1325228
+1325242
Modified: websites/staging/mrunit/trunk/content/mrunit/development/edit_website.html
==============================================================================
--- websites/staging/mrunit/trunk/content/mrunit/development/edit_website.html (original)
+++ websites/staging/mrunit/trunk/content/mrunit/development/edit_website.html Thu Apr 12 13:14:44 2012
@@ -81,26 +81,46 @@
<h1 class="title">Edit Website</h1>
<p>The website uses the Apache CMS. More detailed documentation is available on
-the Apache Infrastructure pages including a <a href="http://apache.org/dev/cms.html#usage">quickstart guide</a> and a
-<a href="http://apache.org/dev/cmsref.html">reference manual</a>. It is also useful to look at <a href="http://apache.org/dev/cmsadoption.html">other Apache CMS sites</a>
-for examples.</p>
+the Apache Infrastructure pages including a quickstart guide on the
+<a href="http://apache.org/dev/cms.html#usage">Apache bookmarklet</a> and a <a href="http://apache.org/dev/cmsref.html">reference manual</a>. It is also useful to look at
+<a href="http://apache.org/dev/cmsadoption.html">other Apache CMS sites</a> for examples.</p>
<h2 id="process">Process</h2>
<ol>
-<li>Commit a change to the website's source <a href="http://daringfireball.net/projects/markdown/syntax">Markdown</a> files located in
-<a href="https://svn.apache.org/repos/asf/incubator/mrunit/site/trunk">https://svn.apache.org/repos/asf/incubator/mrunit/site/trunk</a>. If deleting a
-file or changing the name of a file make a trivial edit to lib/path.pm or
-lib/view.pm to force a full site rebuild.</li>
-<li>Wait a few minutes to get the email on the commits list that buildbot has
-rebuilt the <a href="http://mrunit.staging.apache.org/mrunit/">staging website</a>.</li>
<li>
-<p>If the change looks ok, commit the change to the production website by:</p>
+<p>Commit a change to the website's source <a href="http://daringfireball.net/projects/markdown/syntax">Markdown</a> files located in
+<a href="https://svn.apache.org/repos/asf/incubator/mrunit/site/trunk">https://svn.apache.org/repos/asf/incubator/mrunit/site/trunk</a>. Before
+committing test that the site still builds locally by installing the
+<a href="http://apache.org/dev/cmsref.html#local-build">CMS build scripts</a> and running:</p>
+<div class="codehilite"><pre><span class="n">buildsite</span><span class="o">/</span><span class="n">build_site</span><span class="o">.</span><span class="n">pl</span> <span class="o">--</span><span class="n">source</span><span class="o">-</span><span class="n">base</span> <span class="n">mrunit</span><span class="o">-</span><span class="n">site</span> <span class="o">--</span><span class="n">target</span><span class="o">-</span><span class="n">base</span> <span class="n">mrunit</span><span class="o">-</span><span class="n">website</span>
+</pre></div>
+
+
+<p>If deleting a file or changing the name of a file make a trivial edit to
+lib/path.pm or lib/view.pm to force a full site rebuild. If making a simple edit
+it is easier to just use the Apache bookmarklet.</p>
+</li>
+<li>
+<p>Wait a few minutes to get the email on the commits list that buildbot has
+rebuilt the <a href="http://mrunit.staging.apache.org/mrunit/">staging website</a>.</p>
+</li>
+<li>
+<p>If the change looks ok, commit the change to the production website by one
+of the following:</p>
<ul>
-<li>Using the <a href="http://apache.org/dev/cms.html#usage">Apache bookmarklet</a> and selecting <a href="https://cms.apache.org/mrunit/publish">Publish site</a></li>
+<li>Using the Apache bookmarklet and selecting <a href="https://cms.apache.org/mrunit/publish">Publish site</a></li>
<li>curl -sL http://s.apache.org/cms-cli | perl on your local machine</li>
-<li>ssh -t <user>@people.apache.org publish.pl mrunit <your Apache ID></li>
+<li>ssh -t <user>@people.apache.org publish.pl mrunit <your Apache ID></li>
</ul>
</li>
</ol>
+<h2 id="style">Style</h2>
+<ul>
+<li>Try to limit line length to 80 columns, fold -s <filename> on Linux is
+helpful for limiting line length</li>
+<li>Use links in the [link name][] style rather than [link name][1] because it
+is more difficult to match up the numbers and removing links causes all the
+numbers to have to get updated</li>
+</ul>
</div>
<div id="footera">