howto/maintain: mark titles for asciidoc
authorJunio C Hamano <gitster@pobox.com>
Fri, 4 Jan 2013 06:56:12 +0000 (22:56 -0800)
committerJunio C Hamano <gitster@pobox.com>
Fri, 4 Jan 2013 06:59:47 +0000 (22:59 -0800)
Documentation/howto/maintain-git.txt
index aaa0c5407a9227821766ff22e6be9d5f83ba33ab..d90230726489b4600a624e166f3c0c46bc65a102 100644 (file)
@@ -6,6 +6,9 @@ Abstract: Imagine that git development is racing along as usual, when our friend
  hordes of suckers (loyal developers), you have been tricked (chosen) to
  step up as the new maintainer. This howto will show you "how to" do it.
 
+Activities
+----------
+
 The maintainer's git time is spent on three activities.
 
  - Communication (45%)
@@ -25,12 +28,13 @@ The maintainer's git time is spent on three activities.
 
    Scratching my own itch and sending proposed patch series out.
 
+The Policy
+----------
+
 The policy on Integration is informally mentioned in "A Note
 from the maintainer" message, which is periodically posted to
 this mailing list after each feature release is made.
 
-The policy.
-
  - Feature releases are numbered as vX.Y.Z and are meant to
    contain bugfixes and enhancements in any area, including
    functionality, performance and usability, without regression.
@@ -79,6 +83,9 @@ The policy.
    are found before new topics are merged to 'master'.
 
 
+A Typical Git Day
+-----------------
+
 A typical git day for the maintainer implements the above policy
 by doing the following:
 
@@ -320,6 +327,9 @@ by doing the following:
  - Push the integration branches out to public places; Meta/pushall
    script may aid this step.
 
+Observations
+------------
+
 Some observations to be made.
 
  * Each topic is tested individually, and also together with other
@@ -353,9 +363,11 @@ Some observations to be made.
    'master' branch typically is.
 
 
-[Appendix]
+Appendix
+--------
 
 Preparing a "merge-fix"
+~~~~~~~~~~~~~~~~~~~~~~~
 
 A merge of two topics may not textually conflict but still have
 conflict at the semantic level. A classic example is for one topic