cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Filip Maj (JIRA)" <>
Subject [jira] [Commented] (CB-12398) Update users guide to document which application artifacts to include/exclude from git
Date Fri, 14 Jul 2017 14:33:00 GMT


Filip Maj commented on CB-12398:

Agreed, I think this one is important. It is a common topic of discussion in Cordova.

How I see it, the _dream_ is to completely ignore the {{platforms/}} folder and its contents
and treat them as build artifacts. The _reality_ today is that Cordova cannot keep up and
abstract over / provide options for every single potential native platform detail / option.

So, for this particular issue, I would try to document / explain both Cordova's goal and how
it tries to keep up and evolve with native platform changes, but let users know the reality
that the safer move is to version control the native build artifacts for the moments where
a developer may need to dive in and tweak something that Cordova does not yet support changing
via tooling.

> Update users guide to document which application artifacts to include/exclude from git
> --------------------------------------------------------------------------------------
>                 Key: CB-12398
>                 URL:
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: cordova-docs
>            Reporter: Chris Brody
>              Labels: backlog
> In ("Create your first
Cordova app") it is not clear which artifacts should or should not be committed in git or
other source code control systems. This can lead to lots of confusion. We know that in general
the developer should use the --save flag when adding all plugins/platforms and then exclude
these artifacts from git. But this is not at all clear to new users and I have seen too many
projects with old plugins/platforms artifacts included.
> We know that part of the right solution in CB-12008 (autosave plugins/platforms by default
in cordova@7) is in progress. I also raised CB-12397 to add .gitignore to the app generated
by "cordova create". But I would also like to see this documented for new users.

This message was sent by Atlassian JIRA

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message