I would like to:
1. Delete the docs/ directory from all plugins
- They contain stale copies of what's in cordova-docs
2. Move plugin information found in cordova-docs into a single README.md
file within the respective plugin repos
3. Delete the "API Reference" section of cordova-docs
4. Add
>> 2. Move plugin information found in cordova-docs into a single README.md
file within the respective plugin repos
And also remove the /cordova/ folder from cordova-docs, right? This way
there will be only one single location for a plugin's documentation (the
README.md file inside that plugin repo
Mike, actually I think with this proposal it should be easier than ever to
match plugin to docs specific to its version.
The documentation would come bundled with the plugin, so you can find the
README.md alongside wherever your plugin code resides, be that an old
download, a plugman install, or f
RE my last suggest about CLI command for plugin docs, I'm now thinking it
would be better to do something like we plan for tests: ship an app that
hosts the docs based on whichever plugins you have installed. Perhaps the
test app should even do both tasks?
On Fri, Dec 13, 2013 at 2:06 PM, Michal
On Fri, Dec 13, 2013 at 2:08 PM, Michal Mocny wrote:
> RE my last suggest about CLI command for plugin docs, I'm now thinking it
> would be better to do something like we plan for tests: ship an app that
> hosts the docs based on whichever plugins you have installed. Perhaps the
> test app shoul
+1
(we should time this for the plugins.cordova.io refactor/release so we
don't have a period of zero published plugin documentation)
On Sat, Dec 14, 2013 at 6:47 AM, Andrew Grieve wrote:
> On Fri, Dec 13, 2013 at 2:08 PM, Michal Mocny wrote:
>
> > RE my last suggest about CLI command for plu
Hi Andrew,
I like this plan. It aligns perfectly with where I want the docs to go.
I would rather see each plugin use a "doc/index.md" file for the API
documentation. However, since plugins.cordova.io should auto-generate the
README.md to HTML, it makes sense to use that file instead. However, I
ya I like that plan too
README should just be simple description of what it is and how to install
does raise the query: should plugin install automate config.xml tags?
On Sat, Dec 14, 2013 at 8:22 AM, Michael Brooks wrote:
> Hi Andrew,
>
> I like this plan. It aligns perfectly with where I wan
+1 from me, makes sense
On Fri, Dec 13, 2013 at 2:07 PM, Brian LeRoux wrote:
> ya I like that plan too
>
> README should just be simple description of what it is and how to install
>
> does raise the query: should plugin install automate config.xml tags?
>
>
> On Sat, Dec 14, 2013 at 8:22 AM, M
love the idea.
On Dec 13, 2013 3:24 PM, "Shazron" wrote:
> +1 from me, makes sense
>
>
> On Fri, Dec 13, 2013 at 2:07 PM, Brian LeRoux wrote:
>
> > ya I like that plan too
> >
> > README should just be simple description of what it is and how to install
> >
> > does raise the query: should plugi
SGTM. And where the plugin docs are removed from cordova-docs, there should be
instructions on where consumers can find the relocated plugin docs.
Issue created: https://issues.apache.org/jira/browse/CB-5658
Brian - no need to align this with plugins.cordova.io release. Until then,
we can point at the github renderings of the READMEs
Michael - Just to clarify, you're suggesting that we put all docs-related
files *except* the main README.md
> Michael - Just to clarify, you're suggesting that we put all docs-related
> files *except* the main README.md within "docs/"? This plays well with
> github, but wanted to clarify. Maybe translations can one day go in
> docs_translated/$LANGUAGE
## project-name/README.md
The file should be targe
This is now done! Woo! No more having plugins code separate from their docs
(I hear we might even get tests to live within plugin repos in the next
while too!).
I tried to be diligent, but it's possible I made mistakes along the way.
You can see the result on the edge version of the docs:
http://c
Nice Andrew.
I think the "Plugins API" page is a good start. We can iterate on it
to improve the experience.
Personally, I would rather not have cut out the quick examples, full
examples, etc. Some of the most positive feedback for our
documentation is that it's thorough and copy & paste ready. T
+1 to Michael's comments.
And I know it is a bit too early to do this, but the links to the docs on
github should point to the master branch, not the dev branch, correct?
I don't think there is anything wrong with big docs, as long as they are useful
and navigable.
Thanks!
The problem I saw with the full examples, is that they are copy & pastes of
the "Quick Examples", but put within an html page and an onDeviceReady
callback. Given that the default app templates already have this, is it
really necessary to have it in every example? You can still copy & past
We'll point them to master as soon as the docs exist on master.
On Thu, Dec 19, 2013 at 4:13 PM, Marcel Kinard wrote:
> +1 to Michael's comments.
>
> And I know it is a bit too early to do this, but the links to the docs on
> github should point to the master branch, not the dev branch, correct
:agri...@google.com] On Behalf Of Andrew Grieve
Sent: Wednesday, December 18, 2013 10:40 PM
To: dev
Subject: Fwd: Deleting Plugin Docs
This is now done! Woo! No more having plugins code separate from their docs
(I hear we might even get tests to live within plugin repos in the next
while too!).
I tried
Grieve
> Sent: Wednesday, December 18, 2013 10:40 PM
> To: dev
> Subject: Fwd: Deleting Plugin Docs
>
> This is now done! Woo! No more having plugins code separate from their docs
> (I hear we might even get tests to live within plugin repos in the next
> while too!).
>
Twitter: @johnwargo
>
>
> -Original Message-
> From: agri...@google.com [mailto:agri...@google.com] On Behalf Of Andrew
> Grieve
> Sent: Wednesday, December 18, 2013 10:40 PM
> To: dev
> Subject: Fwd: Deleting Plugin Docs
>
> This is now done! Woo! No more having plugi
t;
> > -Original Message-
> > From: agri...@google.com [mailto:agri...@google.com] On Behalf Of Andrew
> > Grieve
> > Sent: Wednesday, December 18, 2013 10:40 PM
> > To: dev
> > Subject: Fwd: Deleting Plugin Docs
> >
> > This is now done! Woo!
? Being able to click and link around within a particular
> > > plugin's doc is super helpful.
> > >
> > > John M. Wargo
> > > Twitter: @johnwargo
> > >
> > >
> > > -Original Message-
> > > From: agri...@google.com [
n docs so they generate the pages like
>> > > they used to? Being able to click and link around within a particular
>> > > plugin's doc is super helpful.
>> > >
>> > > John M. Wargo
>> > > Twitter: @johnwargo
>> > >
>> &g
t;> >
> >> > > Andrew,
> >> > >
> >> > > Will you be processing the plugin docs so they generate the pages
> like
> >> > > they used to? Being able to click and link around within a
> particular
> >> > > plugin
ey used to? Being able to click and link around within a particular
> > > plugin's doc is super helpful.
> > >
> > > John M. Wargo
> > > Twitter: @johnwargo
> > >
> > >
> > > -Original Message-
> > > From: agri...@google.
> > > plugin's doc is super helpful.
> > > >
> > > > John M. Wargo
> > > > Twitter: @johnwargo
> > > >
> > > >
> > > > -Original Message-
> > > > From: agri...@google.com [mailto:agri...@g
antan...@gmail.com]
Sent: Friday, December 20, 2013 11:39 AM
To: dev@cordova.apache.org
Subject: Re: Deleting Plugin Docs
I'm a bit lost
Is the eventual goal to build the docs as a single website (docs.cordova.io)
with multiple repos cordova-docs repo and plugin repos?
On Fri, Dec 20, 2013 at 11:00
gt; lost if we do plugin-centric docs, right?
>
> John M. Wargo
> Twitter: @johnwargo
>
> -Original Message-
> From: Carlos Santana [mailto:csantan...@gmail.com]
> Sent: Friday, December 20, 2013 11:39 AM
> To: dev@cordova.apache.org
> Subject: Re: Deleting Plugin Docs
&
ation events for example? Those get
> lost if we do plugin-centric docs, right?
>
> John M. Wargo
> Twitter: @johnwargo
>
> -Original Message-
> From: Carlos Santana [mailto:csantan...@gmail.com]
> Sent: Friday, December 20, 2013 11:39 AM
> To: dev@cordova.apache.org
30 matches
Mail list logo