[ 
https://issues.apache.org/jira/browse/CB-12398?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16087388#comment-16087388
 ] 

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: https://issues.apache.org/jira/browse/CB-12398
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: cordova-docs
>            Reporter: Chris Brody
>              Labels: backlog
>
> In https://cordova.apache.org/docs/en/latest/guide/cli/index.html ("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
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to