Changes between Version 11 and Version 12 of CookBook/About

Timestamp:

Feb 16, 2015, 8:25:44 PM (9 years ago)

Author:

figaro

Comment:

Reordered paragraphs

CookBook/About

@@ -1 +1 @@
 [[PageOutline]]
-= Trac Cookbook =
-== Introduction ==
-Loads of information on how to accomplish particular tasks with Trac already exists in one form or another in forum posts, blogs, third party web pages, and even the Trac documentation. However, this non-centralized information can sometimes be hard to find, especially if the "answer" is buried in forum threads. Often the prerequisites for the answer -- conceptual, hardware or software -- are missing. And after all, there is no guarantee that the solution will actually work.
+= Trac Cookbook
+
+== Introduction
+
+Loads of information on how to accomplish particular tasks with Trac already exists in forum posts, blogs, third party web pages, and even the Trac documentation. However, this non-centralized information can sometimes be hard to find, especially if the "answer" is buried in forum threads. Often the prerequisites for the answer - conceptual, hardware or software - are missing. And after all, there is no guarantee that the solution will actually work.
 
 A good "recipe" will be '''a complete how-to''', so that one should be able to end up with the desired goal at the end of the steps, with all prerequisites and all intermediate steps. Ideally, the "why" for the steps is be included.
@@ -8 +10 @@
 A "recipe" is a clear and reliable set of instructions that have a high probability of working under a broad range of conditions. Recipes should also be complete and self-contained.
 
-== Sources for Recipes ==
+== Can I submit a recipe?
+
+Sure, go ahead! However, make sure the recipe is valid, such as describing a successful deployment start to end. If you go halfway and get stuck somewhere, get help and feedback first, before writing up the recipe. See also InstallationIssue for what to do in this case.
+
+== Sources for Recipes
 
 The cookbook is open to both suggestions for recipes and the recipes themselves.
@@ -35 +41 @@
 }}}
 
-== Can I submit a recipe? ==
-
-Sure, go ahead! However, make sure the recipe is valid, such as describing a successful deployment start to end. If you go halfway and get stuck somewhere, get help and feedback first, before writing up the recipe. See also InstallationIssue for what to do in this case.
-
 ----
 See also: SeaChange/DocumentationRequests