Author: buildbot
Date: Sat Mar 29 16:41:06 2014
New Revision: 904174
Log:
Staging update by buildbot for thrift
Modified:
websites/staging/thrift/trunk/content/ (props changed)
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
Propchange: websites/staging/thrift/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sat Mar 29 16:41:06 2014
@@ -1 +1 @@
-1582972
+1583024
Modified:
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
==============================================================================
---
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
(original)
+++
websites/staging/thrift/trunk/content/docs/committers/HowToThriftWebsite.html
Sat Mar 29 16:41:06 2014
@@ -97,6 +97,17 @@ committing to the CMS's svn tree for thr
changes so it can automatically (and efficiently) build them to the staging
site, just as if
you were working locally with a daemon that watches your filesystem for
modifications and
builds them.</p>
+<p>Remember most of all that markdown is aimed first at foremost at human
readers, so try to
+ensure your source content is easily understood by</p>
+<div class="codehilite"><pre><span class="o">-</span> <span
class="n">Keeping</span> <span class="n">headings</span> <span
class="n">separated</span> <span class="n">from</span> <span
class="n">other</span> <span class="n">content</span> <span
class="n">with</span> <span class="n">surrounding</span> <span
class="n">blank</span> <span class="n">lines</span><span class="p">,</span>
+<span class="o">-</span> <span class="n">Avoiding</span> <span
class="n">long</span> <span class="n">lines</span> <span class="n">of</span>
<span class="n">text</span><span class="p">,</span> <span
class="n">wrapping</span> <span class="n">at</span> 80<span
class="o">-</span>100 <span class="n">characters</span> <span
class="n">on</span> <span class="n">average</span><span class="p">,</span>
+<span class="o">-</span> <span class="n">Keeping</span> <span
class="n">embedded</span> <span class="n">HTML</span> <span
class="n">separated</span> <span class="n">from</span> <span
class="n">markdown</span> <span class="n">content</span> <span
class="n">by</span> <span class="n">blank</span> <span
class="n">lines</span><span class="p">,</span>
+<span class="o">-</span> <span class="n">Preferring</span> <span
class="n">four</span><span class="o">-</span><span class="n">space</span> <span
class="n">indents</span> <span class="n">per</span> <span
class="n">level</span> <span class="n">over</span> <span class="n">tab</span>
<span class="n">characters</span><span class="p">.</span>
+</pre></div>
+
+
+<p>Not only will your readers prefer a clean style, it will result in fewer
bugs and a more
+consistent experience with the various markdown parsers deployed by the
CMS.</p>
<h3 id="updating-release-versions">Updating Release Versions</h3>
<p>The current release versioning is kept in the YAML <strong>DATA</strong>
section of the global "configuration
file" <a
href="https://svn.apache.org/repos/asf/thrift/cms-site/trunk/lib/path.pm";>lib/path.pm</a>.
Update
