[
https://issues.apache.org/jira/browse/CB-13338?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16184042#comment-16184042
]
Jan Piotrowski (Sujan) edited comment on CB-13338 at 9/28/17 11:53 AM:
-----------------------------------------------------------------------
Thanks for these clarifications, I now much better understand what is going on.
For example it wasn't clear to me that Gulp and Make are alternatives for the
same process.
As I already mentioned on Slack, I am not interested in changing the process -
just document it better so one can get an overview what is going on without
having to install everything just to find out what the build process actually
does. This will also make it easier to contribute to the website, docs etc.
was (Author: sujan12):
Thanks for these clarifications, I now much better understand what is going on.
For example it wasn't clear to me that Gulp and Make are alternatives for the
same process.
As I already mentioned on Slack, I am not interested in changing the process -
just document it better so one can get an impression what is going on without
having to install everything just to find out what the build process actually
does.
> How does the build process work?
> --------------------------------
>
> Key: CB-13338
> URL: https://issues.apache.org/jira/browse/CB-13338
> Project: Apache Cordova
> Issue Type: Sub-task
> Components: cordova-docs
> Reporter: Jan Piotrowski (Sujan)
>
> 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:
> # How does the build process with Make work? Is this documented?
> # What is python required for?
> # What is node.js required for? gulp?
> # What does the gulp thing actually do? The README only mentions serve,
> watch, build - but the gulpfile contains _so_ much more.
> # What workflows or processes are "hidden" in the gulpfile that should better
> be documented?
> # What is the difference between PROD and DEV in this build process?
> # How does the fetching of external docs work?
> # Is there anything about translations in there?
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org
For additional commands, e-mail: issues-h...@cordova.apache.org
