[CB-13338] How does the build process work?

• Type: Sub-task
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: cordova-docs
• Assignee: Unassigned
• Reporter: Jan Piotrowski (janpio)
• Created: 26/Sep/17 15:13
• Updated: 28/Sep/17 11:53

Description

Per https://github.com/apache/cordova-docs/blob/master/README.md#building and https://github.com/apache/cordova-docs/blob/master/README.md#developing the build process of the website is handled by `gulp`.

https://github.com/apache/cordova-docs/blob/master/README.md#installing tells us to install Ruby, python, Node.js, the dependencies _for both Ruby and Node, and optionally _Make.

From looking at `www` I know the website is actually a Jekyll website.

This leads to a very confused me and several questions:

1. How does the build process with Make work? Is this documented?
2. What is python required for?
3. What is node.js required for? gulp?
4. What does the gulp thing actually do? The README only mentions serve, watch, build - but the gulpfile contains so much more.
5. What workflows or processes are "hidden" in the gulpfile that should better be documented?
6. What is the difference between PROD and DEV in this build process?
7. How does the fetching of external docs work?
8. Is there anything about translations in there?

Issue Links

• is related to: CB-13335 Document autogenerated files better