RE: create and override of default template

2013-10-28 Thread Michael Sierra
Please assign doc fix to me, thanks. Am going to try to keep CLI doc from spinning out of control the more features you guys add to it. ;-) --Mike Sierra From: Ray Camden [rayca...@adobe.com] Sent: Friday, October 25, 2013 4:57 PM To: dev@cordova.apache

RE: config.xml discussion, we need to talk

2013-10-21 Thread Michael Sierra
I've been meaning to catch up with this thread, and haven't had time to do it justice. My high-level takeaway so far is: doc must better clarify relative benefits of CLI vs. platform-level tooling. I've been revamping doc to try to address both workflows, so any lapses on that front are surel

RE: Updating docs

2013-10-15 Thread Michael Sierra
Achana, Good questions. I've been reorganizing the content a great deal, and have been meaning to write up some sort of doc roadmap, which I'll bootstrap here. The "Platform Guides" are where most of the platform-specific content lives, in various directories within edge/guide/platforms. See the

RE: Updating plugin code on prepare

2013-09-27 Thread Michael Sierra
Can you please file JIRAs on doc problems like this? Existing overview doc says you can use the CLI to bootstrap & hand off to an SDK & supporting platform command-line utilities. I take your comment to mean doc should better stress that once you start working with platform tools downstream,

RE: config.xml discussion, we need to talk

2013-09-26 Thread Michael Sierra
I'm about to try to better clarify current behavior in the doc. I understand when using the CLI to build, the `platforms/*/www/config.xml` files come from passively copying the web-assets source directory. (Excpetion: Android's ends up in `platforms/android/assets/www/config.xml`.) If you swi

RE: config.xml doc queries

2013-09-18 Thread Michael Sierra
ault", it will internally use "auto", but we'll double check. backgroundColor - We use ARGB as well, ie 0x All preferences are case insensitive +1 on consolidating docs for prefs being used in all platforms On Fri, Sep 13, 2013 at 1:05 PM, Michael Sierra wrote: > A follow-u

RE: config.xml doc queries

2013-09-13 Thread Michael Sierra
A follow-up query. The BB doc says "8 digits". Assuming each doc is accurate, would you be able to use gap:platform to assign different preference values? E.g.: --Mike S ____ From: Michael Sierra Sent: Friday, September 13, 2013 11:23

config.xml doc queries

2013-09-13 Thread Michael Sierra
I'm doing a bunch of cleanup work on the doc about config.xml preferences, and have accumulated a faceful of queries I could use some help with. I'm also folding in some parallel PhoneGap Build doc where appropriate, but suspect some of it may be out of date. At least one preference applies only to

RE: core APIs and the CLI

2013-08-30 Thread Michael Sierra
To clarify, current doc doesn't specify a full path for the config.xml, which I'll fix throughout. Safe to assume this issue applies to all features? When using the CLI to add/rm features, the one in the dir is modified. But if you're using the SDK, isn't it the one in the www dir? I agree

RE: WP8 'Plugin interface' and 'Splash screen' support

2013-08-01 Thread Michael Sierra
rt device-dialogs because of the partially added notification.prompt Sent from my iPhone > On Aug 1, 2013, at 8:39 AM, Michael Sierra wrote: > > OK to interpret "has some issues" as "doesn't work"? ;-) In that case, > I'll mark File as partial for

changes to platform support doc

2013-08-01 Thread Michael Sierra
After comparing the support table in the Overview section & the support listed in the API doc, I made various changes based on the following assumptions. Please speak up if any are incorrect: * wp7 & wp8 both support splashscreen * bb10 supports splashscreen * bb10 supports compass * Only bb1

RE: WP8 'Plugin interface' and 'Splash screen' support

2013-08-01 Thread Michael Sierra
wrote: > > > > >BB10 CLI will work on Linux, BBOS has no CLI support > > > > > >I'm having trouble tracking down where the compass plugin is hosted. If > > >BB10 doesn't support this right now, we should be able to add it quickly > > > &g

RE: Command-line completion in Cordova CLI

2013-07-31 Thread Michael Sierra
For doc, pls clarify if tab completion is to be built into the product, or if it involves a separate install. I assume it works for clearly constrained sets of choices such as "plugin rm" rather than "plugin add". Correct? Point me towards any appropriate info. Thanks --Mike S __

RE: WP8 'Plugin interface' and 'Splash screen' support

2013-07-31 Thread Michael Sierra
I can see another couple of problems that need to be fixed. Please take a moment to review this table for any platform you're particularly familiar with. Thanks, --Mike Sierra From: Sergey Grebnov (Akvelon) [v-seg...@microsoft.com] Sent: Wednesday, Jul

RE: authoring docs

2013-07-30 Thread Michael Sierra
Thanks. I've been adding to it randomly & without a great deal of thought as I go. I'd be interested in any feedback for any issues you notice are treated inconsistently in the doc. --Mike S From: Marcel Kinard [cmarc...@gmail.com] Sent: Monday, July

RE: Is Formatting issue fixed?

2013-07-29 Thread Michael Sierra
Yes, you can close it up, thanks From: Sharif Ahmed [sharifdu...@gmail.com] Sent: Friday, July 26, 2013 12:29 PM To: dev@cordova.apache.org Subject: Re: Is Formatting issue fixed? Ok, should I close my issue? On 7/26/13, Michael Sierra wrote: > The

RE: Is Formatting issue fixed?

2013-07-26 Thread Michael Sierra
The fix is in & regenerated at phonegap.com, not yet on apache.org. Sorry, will remember to preview next time! --Mike S From: Sharif Ahmed [sharifdu...@gmail.com] Sent: Friday, July 26, 2013 4:56 AM To: dev Subject: Is Formatting issue fixed? In the The

RE: Aliases for 'core' plugins

2013-07-23 Thread Michael Sierra
I had the same thought & added it as a wish-list CB-4290. --Mike S From: Ray Camden [rayca...@adobe.com] Sent: Tuesday, July 23, 2013 2:23 PM To: dev@cordova.apache.org Subject: Aliases for 'core' plugins One of the things I discovered while working with

RE: cli docs - spaces in main activity name

2013-07-22 Thread Michael Sierra
I just added a JIRA CB-4343 for bb10 & modified it to include android. This appears new to 3.0; had no problem with "Hello World" prior. --Mike S From: brian.ler...@gmail.com [brian.ler...@gmail.com] On Behalf Of Brian LeRoux [b...@brian.io] Sent: Mond

RE: Issues with documentation

2013-07-19 Thread Michael Sierra
Sorry, my bad. Added commit 1bb993e to pull req #81, which should fix this. --Mike S From: Filip Maj [f...@adobe.com] Sent: Friday, July 19, 2013 4:16 PM To: dev@cordova.apache.org Subject: Re: Issues with documentation Filed here https://issues.apache.

RE: Upgrading Guides

2013-07-17 Thread Michael Sierra
On Wed, Jul 17, 2013 at 1:06 PM, Michael Sierra wrote: > I committed a change to the CLI doc that details plugin add/rm/ls based on > this doc. The plugman interface should be doc'ed separately to avoid > confusion. Am editing the plugman doc a bit & will figure out where

RE: Upgrading Guides

2013-07-17 Thread Michael Sierra
I committed a change to the CLI doc that details plugin add/rm/ls based on this doc. The plugman interface should be doc'ed separately to avoid confusion. Am editing the plugman doc a bit & will figure out where to place it, but I'd like to confirm the overall use case. I see it as: you want to

RE: Upgrading Guides

2013-07-16 Thread Michael Sierra
I'll add links to the CLI doc from each Upgrading doc, then expand the CLI doc a bit to discuss in general terms how to upgrade from a non-CLI project. Not familiar with any platform-specific variations, info about which would belong on each platform's Upgrading Guide, but I assume it's basicall

RE: Upgrading Guides

2013-07-16 Thread Michael Sierra
FYI: I split the "Upgrading Guide" into more digestible platform-specific docs available under "Platform Guides" (edge/guide/platforms/*/upgrading.md). I haven't yet scrutinized whether the content is still relevant, but that's a good idea to note the CLI-based workflow. For now I'll link the

RE: restructuring guide content in doc

2013-07-15 Thread Michael Sierra
Yes, I also understand idea (1) to be out of scope, which is whatever content is in "edge," and see (2) as depending on (1). --Mike S From: Marcel Kinard [cmarc...@gmail.com] Sent: Monday, July 08, 2013 2:51 PM To: dev@cordova.apache.org Subject: Re: res

restructuring guide content in doc

2013-07-05 Thread Michael Sierra
This is a heads-up for some fairly extensive changes to the organization of the cordova-docs guide content. You may have noticed a bunch of new doc-related JIRAs. Of these, #3827 revises the content structure. It adds Overview & CLI sections, which are currently in place. To avoid confusion, I've

RE: [27/46] docs commit: amidst globalization api

2013-06-13 Thread Michael Sierra
That's already in place, with a reference in the top-level README.md. Thanks. I'd keep it out of the README, though, as too much info. Are automatic doc-generation tools doc'ed anywhere? E.g., the conversion of heading text to live links? Granted it's not intrinsic to content, but potentiall

RE: [27/46] docs commit: amidst globalization api

2013-06-13 Thread Michael Sierra
Sure, sorry for the volume. Am working on improving doc, and needed to bring it up to a certain baseline. Will punch in a few JIRAs to clarify plans going forward, and to help organize existing doc bugs. --Mike Sierra From: Marcel Kinard [cmarc...@gmai

issues.apache.org is down

2013-06-11 Thread Michael Sierra
The subject says it all. --Mike S

RE: FW: cordova API doc queries (pause event)

2013-05-22 Thread Michael Sierra
--Mike S From: Shazron [shaz...@gmail.com] Sent: Monday, May 20, 2013 5:05 PM To: dev@cordova.apache.org Cc: Michael Sierra Subject: Re: FW: cordova API doc queries ... * The doc for the "pause" and "retrieve" events say "native code" takes the app in and out of

RE: cordova API doc queries

2013-05-22 Thread Michael Sierra
nding navigator.onLine property? --Mike S From: Ray Camden Sent: Tuesday, May 21, 2013 5:52 PM To: dev@cordova.apache.org Cc: Michael Sierra Subject: Re: cordova API doc queries Are you sure? I built a demo a while ago to show connection handling, and I had to check d

FW: cordova API doc queries

2013-05-20 Thread Michael Sierra
I'm doing some work on the cordova doc, including the API ref. Based on a read-through of existing doc & no testing yet, I collected some queries that Brian Leroux suggested would be appropriate for this list. * The criteria for when online/offline events fire (internet connection) seem vague,