doc: simplify contributing documentation

Trott · Trott · commit 78f2bb1c82f1 · 2019-05-22T16:21:40.000-07:00
Remove out-of-place detail about filesystem layout and tools for generating documentation. Link to the issue tracker and the contribution guide with clear, concise sentences. PR-URL: nodejs#27785 Reviewed-By: Richard Lau <riclau@uk.ibm.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
diff --git a/doc/api/documentation.md b/doc/api/documentation.md
@@ -9,13 +9,9 @@ Node.js is a JavaScript runtime built on the [V8 JavaScript engine][].
 
 ## Contributing
 
-If errors are found in this documentation, please [submit an issue][]
-or see [the contributing guide][] for directions on how to submit a patch.
+Report errors in this documentation in [the issue tracker][]. See
+[the contributing guide][] for directions on how to submit pull requests.
 
-Every file is generated based on the corresponding `.md` file in the
-`doc/api/` folder in Node.js's source tree. The documentation is generated
-using the `tools/doc/generate.js` program. An HTML template is located at
-`doc/template.html`.
 
 ## Stability Index
 
@@ -84,6 +80,6 @@ issue 4760](https://github.com/nodejs/node/issues/4760).
 [`'warning'`]: process.html#process_event_warning
 [`fs.open()`]: fs.html#fs_fs_open_path_flags_mode_callback
 [`stderr`]: process.html#process_process_stderr
-[submit an issue]: https://github.com/nodejs/node/issues/new
 [the contributing guide]: https://github.com/nodejs/node/blob/master/CONTRIBUTING.md
+[the issue tracker]: https://github.com/nodejs/node/issues/new
 [V8 JavaScript engine]: https://v8.dev/
