[jira] [Commented] (CB-5137) docs should describe how to build Cordova from Apache dist

["Marcel Kinard (JIRA)" <ji...@apache.org>]

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

Marcel Kinard commented on CB-5137:
-----------------------------------

Michael Sierra and crew, I have a working version of this that I'd like your review on:
https://github.com/cmarcelk/cordova-docs/commit/b59ef0ae361ccf4b6a9af6c5c6db1aea3163c6ff
Yeah, we need a better way to add local copies of platforms when not fetching them from the repo.

Andrew / Michal / crew, I also would like a couple tweaks to coho:
https://github.com/cmarcelk/cordova-coho/commit/2caafae04d365e44c2fb59e9375bbf0adfae2603

And for the larger community, I believe that zips of plugman and the core plugins should be included in the Apache distribution. I know that they run on a separate release train, but right now plugman and the core plugins are never included in an Apache distribution. I know it's not a common workflow, but it's what I do when building the distribution for my employer's product. I'd suggest to just grab whatever the currently weekly release is, not do another release cycle for plugman / core plugins. Comments?

> docs should describe how to build Cordova from Apache dist
> ----------------------------------------------------------
>
>                 Key: CB-5137
>                 URL: https://issues.apache.org/jira/browse/CB-5137
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: Docs
>            Reporter: Marcel Kinard
>            Assignee: Marcel Kinard
>            Priority: Minor
>
> The docs seem to assume that Cordova was already downloaded either via npm or from a PhoneGap distribution or similar. Though the Apache Way is to distribute source code, it isn't clear to the average consumer in the docs how to get Cordova up and running from either the source zips on dist.apache.org or from the repos at git-wip-us.apache.org. This documentation should be added, perhaps as a section such as "How to Obtain Cordova" and/or "How to Build Cordova from Source".
> There may be additional docs needed that describe how to bootstrap the docs (build the html from the md) if for some reason the user can't get them online at cordova.apache.org/docs.



--
This message was sent by Atlassian JIRA
(v6.1#6144)