com web/doc: Make docgen the preferred choice: tutorial/editing.md

Commit:    be48b4bb26ca4ca2bccfa7981b8560bfcde15ac6
Author:    Sobak <[email protected]>         Mon, 16 Jun 2014 15:56:22 +0200
Parents:   888dbbd8399cce1c5994e68aa7f43be912a6ab39
Branches:  master

Link:       http://git.php.net/?p=web/doc.git;a=commitdiff;h=be48b4bb26ca4ca2bccfa7981b8560bfcde15ac6

Log:
Make docgen the preferred choice

Changed paths:
  M  tutorial/editing.md


Diff:
diff --git a/tutorial/editing.md b/tutorial/editing.md
index 40684c0..ceac7ea 100644
--- a/tutorial/editing.md
+++ b/tutorial/editing.md
@@ -12,7 +12,12 @@ Simply open the files and edit them.
 When adding new functions or methods, there are a couple of options. Either way, the generated (or copied) files
 will need to be filled out.
 
-### Option A: Copy skeleton files
+### Option A: Generating files using docgen
+This is preferred way to generate files for new functions or methods. The `docgen` script is found within 
+the PHP documentation (phpdoc/scripts/docgen/) and uses Reflection to generate documentation (DocBook) files.
+Fill in skeleton files before you commit them!
+
+### Option B: Copy skeleton files
 This involves copying the skeleton files into the correct location:
 ```
 cp /phpdoc/RFC/skeletons/method.xml classname/methodname.xml   #for new methods
@@ -22,9 +27,7 @@ cp /phpdoc/RFC/skeletons/function.xml functions/functionname.xml #for new functi
 Note: *classname*, *methodname* and *functionname* are lowercased names of the class, method or function, respectively,
 not a literal file name.
 
-### Option B: Generating files using docgen
-The `docgen` script is found within the PHP documentation (phpdoc/scripts/docgen/) and uses Reflection to generate
-documentation (DocBook) files. Fill in skeleton files before you commit them!
+Remember about extension [structure](structure.md) when copying those files.
 
 ## Translating documentation
 Translation process has been described in [separate chapter](translating.md).