Changes for Alejandro's feedback

fredemmott · fredemmott · commit 2eb7f6755336 · 2017-03-15T17:33:24.000-07:00
diff --git a/docs/_data/features.yml b/docs/_data/features.yml
@@ -1,13 +1,15 @@
 - title: Signed Files
   text: |
         Generated files are signed to prevent or detect manual modifications of
-        generated code; this can be disabled if required.
+        generated code; these files can then be regenerated with new content in
+        the future, or signatures can be disabled to generate 'skeleton' code,
+        if any future changes will be manual.
 
 - title: Partially Generated Files
   text: |
         Generated code can be marked as containing manually-modifiable
-        sections; you can use hack-codegen to rewrite the rest of the file,
-        and all manual sections will be left unmodified.
+        sections; you can use hack-codegen to rewrite the rest of the file in
+        the future, and all manual sections will be left unmodified.
   
 - title: Readable Output
   text: |
diff --git a/docs/_docs/overview/partially-generated.md b/docs/_docs/overview/partially-generated.md
@@ -38,17 +38,14 @@ require_once(__DIR__.'/../../../vendor/autoload.php');
 /* END MANUAL SECTION */
 ```
 
-While the manual section could be avoided by adding a configuration option to the
-script generator, this requires putting code into a string, which is generally less
-preferable than having it as real code.
+There alternative approaches, however they generall require putting code into
+a string, which is usually less preferable than having it as real code.
 
 One of the reasons that partially-generated files are generally discouraged with
 other frameworks is that major upgrades often require re-creating the files
-completely, then manually re-doing edits.
-
-This isn't the case with Hack Codegen: if a new version of a file contains a manual
-section with the same 'key' as an old version, the old manual section is copied
-into the new manual section.
+completely, then manually re-doing edits; This isn't the case with Hack Codegen:
+if a new version of a file contains a manual section with the same 'key' as an
+old version, the old manual section is copiedi into the new manual section.
 
 Creating Manual Sections
 ------------------------
