cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jan Piotrowski (Sujan) (JIRA)" <j...@apache.org>
Subject [jira] [Comment Edited] (CB-13338) How does the build process work?
Date Thu, 28 Sep 2017 11:54:00 GMT

    [ 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-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org


Mime
View raw message