cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Robert Hoffmann <robert.hoffmann....@gmail.com>
Subject Re: Where to download Cordova shell tools?
Date Wed, 02 Dec 2015 11:07:43 GMT
Thank you for these links!

Please find below some thoughts... maybe they can help you make the 
documentation and user experience for dummies like me even better :)

In hindsight "npm install cordova-android" seems obvious, but I would 
not have guessed it. Especially because I want to be confident about the 
version I am using.


1) So it is good to know where I can get stable but also previous releases:

1a) Using GitHub e.g. https://github.com/apache/cordova-android

1b) https://dist.apache.org/repos/dist/release/cordova


2) Download section

IMHO, from a user (not contributor) perspective a download section 
should basically list Platforms, Plugins, Other (like the Contribute 
page)... but omit the Apache link and instead provide a link to npm (or 
a popup with the command 'npm install cordova-android' to copy)

In other words: GitHub for power users. And npm for convenience.

And I would put Download in the top menu left of Contribute, because you 
surely have more downloading users than contributing users.


3) Then "{Platform} Shell Tool Guide" sections in the documentation 
could point to this download section instead of just cordova.apache.org.

Dealing with shell tools seems unavoidable (e.g. for many plugins) so 
they 'deserve' more emphasis.


4) Generally there is this balancing between cli and shell tools, which 
took me some time to grasp. The fact that cli is a shell tool too did 
not help ;)

Maybe "Power Tools" would be a more appropriate?


5) Regarding GitHub

Could you recommend to git clone cordova-android specifically for one 
app project? And then just update it with (git pull) when needed? 
Following with a project update (i.e. "cordova-android/bin/update")


Thank you and best regards,
Robert



On 02/12/15 02:16, Steven Gill wrote:
> Sure. But for the example above, where someone wants cordova-android 
> (especially with the new platform API), we are going to see more 
> people wanting to require('cordova-android'). We should atleast 
> provide links to our official download distributions on our site. If 
> not on the contributions page, somewhere else. Maybe the repos that 
> aren't published to npm just don't get the link?
>
> Another example, how does someone figure out how to install plugman 
> currently?
>
>
> On Tue, Dec 1, 2015 at 5:12 PM, Dmitry Blotsky <dblotsky@microsoft.com 
> <mailto:dblotsky@microsoft.com>> wrote:
>
>     Footer sounds good to me.
>
>     I’m not a fan of adding NPM links for two reasons though:
>     1). Not every repo should be installed manually via NPM
>     2). The information on the NPM page is already shown on GitHub
>
>     Kindly,
>     Dmitry
>
>     > On Dec 1, 2015, at 4:20 PM, Steven Gill <stevengill97@gmail.com
>     <mailto:stevengill97@gmail.com>> wrote:
>     >
>     > I'd say footer as most of our users aren't going to use dist.
>     >
>     > I think it is worth adding the npm links for all of our repos at
>     >
>     https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2fcontribute%2f&data=01%7c01%7cdblotsky%40microsoft.com%7c5ec7ab5bff404293b51a08d2faae74f7%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=CN9fj7oBBdz9NjcPtMg9lBwmoGWoR1ckyfdzwvKnDGw%3d
>     beside the github and apache git repo
>     > links.
>     >
>     > On Tue, Dec 1, 2015 at 3:59 PM, Dmitry Blotsky
>     <dblotsky@microsoft.com <mailto:dblotsky@microsoft.com>>
>     > wrote:
>     >
>     >> We do have “npm install -g cordova” on the front page, but I
>     guess there
>     >> is no clear link to
>     https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fdist.apache.org%2frepos%2fdist%2frelease%2fcordova%2f&data=01%7c01%7cdblotsky%40microsoft.com%7c5ec7ab5bff404293b51a08d2faae74f7%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=3DOY5UW13ODLMdOC1igajVAavJjIproR0mWP%2bL46z1E%3d
>     >> anywhere. I really like that link and I think it would be great
>     to have it
>     >> easily accessible. I’m leaning toward the header (a bit loud)
>     or the footer
>     >> (a bit hard to find). Where do you folks think it should go?
>     >>
>     >> Kindly,
>     >> Dmitry
>     >>
>     >> On Dec 1, 2015, at 2:12 PM, Steven Gill <stevengill97@gmail.com
>     <mailto:stevengill97@gmail.com><mailto:
>     >> stevengill97@gmail.com <mailto:stevengill97@gmail.com>>> wrote:
>     >>
>     >> If you want cordova-android, you can download it from
>     github[1], npm[2] or
>     >> apache dist[3].
>     >>
>     >> We need to add links to npm + dist on the website. Any thoughts
>     where we
>     >> should add them? Maybe we should add a download section.
>     >>
>     >> [1] https://github.com/apache/cordova-android
>     >> [2]
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fwww.npmjs.com%2fpackage%2fcordova-android&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=GGHnAI%2f5yayUamaOj8SMXpoE1DhmGPAt59g8r9yI2JE%3d
>     >> [3]
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fdist.apache.org%2frepos%2fdist%2frelease%2fcordova%2f&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=U9We28UuDLFjnOaKQgqNRfBAEqJJteyP%2fqHfyvcQb7E%3d
>     >>
>     >> On Tue, Dec 1, 2015 at 7:20 AM, Robert Hoffmann <
>     >> robert.hoffmann.phd@gmail.com
>     <mailto:robert.hoffmann.phd@gmail.com><mailto:robert.hoffmann.phd@gmail.com
>     <mailto:robert.hoffmann.phd@gmail.com>>>
>     >> wrote:
>     >>
>     >> Hi,
>     >>
>     >> The cordova documentation refers multiple time to "download from
>     >>
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=cordova.apache.org&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=BE5ImGaeeiU0b73d8qvcUWwPXMpKVGaMjuEDAXusDGo%3d
>     >> "
>     >>
>     >> e.g.
>     >>
>     >>
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2fdocs%2fen%2flatest%2fguide%2fplatforms%2fandroid%2ftools.html&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=hkjD6j9615mybO%2b%2bjcmmKSTuheVaRaZoRJSQN5zD1uE%3d
>     >> "To enable shell tools for Android, download Cordova from
>     >> cordova.apache.org <http://cordova.apache.org>. The download
>     contains separate archives for each
>     >> platform."
>     >>
>     >>
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2fdocs%2fen%2flatest%2fguide%2foverview%2findex.html&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=9bqMnb8zi%2fiUvgDenS7TIgDEsnaV5mP89E9jky9fEtE%3d
>     >> "Lower-level shell utilities are available at
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=cordova.apache.org&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=BE5ImGaeeiU0b73d8qvcUWwPXMpKVGaMjuEDAXusDGo%3d
>     >> in a
>     >> separate distribution than the CLI"
>     >>
>     >>
>     >> But at
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2f&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=hc857cM2xzUvrzC9V0zEUlgfKfCvynjPZN37iAAwXl8%3d
>     >> there is no download section (at least
>     >> none that I could find).
>     >>
>     >> Under the menu Contribute "
>     >>
>     https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2fcontribute%2f&data=01%7c01%7cdblotsky%40microsoft.com%7c8b5b6e4b8fa2407e1ec208d2fa9c8e90%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=PzScgbaOegMDg2EwYuVpM7fbS%2fuA7I1a3QHwAcg1olw%3d"
>     >> there
>     >> are links to github projects...
>     >>
>     >> Is this the place to download platform shell tools (e.g.
>     cordova-android)?
>     >>
>     >> But what about stable releases, are they available somewhere?
>     >>
>     >> Sorry, if I should be missing something very basic.
>     >>
>     >> Thank you,
>     >> Robert
>     >>
>     >>
>     >>
>     ---------------------------------------------------------------------
>     >> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>     <mailto:dev-unsubscribe@cordova.apache.org>
>     >> For additional commands, e-mail: dev-help@cordova.apache.org
>     <mailto:dev-help@cordova.apache.org>
>     >>
>     >>
>     >>
>     >>
>
>


Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message