Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
MIME-Version: 1.0
In-Reply-To: 
 <CAHYtTqnx4Y8DUi+JsfZLo40Z8U2u98jd2sZSEMXUJSaCS0bcZQ@mail.gmail.com>
References: 
 <DM2PR03MB351BF7E38D29CD483EF6B9DD8090@DM2PR03MB351.namprd03.prod.outlook.com>
	<AA5193D6-3CDC-4061-9CEA-31998D2F10F5@microsoft.com>
	<CAHYtTqnx4Y8DUi+JsfZLo40Z8U2u98jd2sZSEMXUJSaCS0bcZQ@mail.gmail.com>
Date: Sat, 12 Dec 2015 01:20:23 +0600
Message-ID: 
 <CAAY=exjB6wEGuYyCnik4HJjNzhDk0an2EPQchswKXGd3r32T-g@mail.gmail.com>
Subject: Re: [DISCUSS] New Information Architecture for Cordova Website
From: Andrey Kurdumov <kant2002@googlemail.com>
To: dev@cordova.apache.org
Content-Type: multipart/alternative; boundary=001a113988d204d7180526a437af

--001a113988d204d7180526a437af
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

I add comments on the docs structure to PR with notes why I think it that
way. This is based on my personal struggling with finding something on
docs, and other dumb questions which people asking on SO.

2015-12-11 20:40 GMT+06:00 Carlos Santana <csantana23@gmail.com>:

> yes I agree Reference your be top level at TOC, I left other comments in
> the PR
>
> On Thu, Dec 10, 2015 at 3:28 PM Dmitry Blotsky <dblotsky@microsoft.com>
> wrote:
>
> > Hey folks,
> >
> > Please take a look at the PR discussing this proposal:
> > https://github.com/cordova/cordova-discuss/pull/31.
> >
> > Personally, I=E2=80=99d like to solicit opinions on having the Referenc=
e section
> > be a top-level title outside of the specific use cases.
> >
> > Kindly,
> > Dmitry
> >
> > On Dec 7, 2015, at 3:24 PM, Raghav Katyal <rakatyal@microsoft.com
> <mailto:
> > rakatyal@microsoft.com>> wrote:
> >
> > Looks like something is messing up with the formatting. Kindly refer to
> > the discuss PR in the mail.
> >
> > -Raghav
> >
> > From: Raghav Katyal
> > Sent: Monday, December 7, 2015 3:19 PM
> > To: 'dev@cordova.apache.org<mailto:dev@cordova.apache.org>' <
> > dev@cordova.apache.org<mailto:dev@cordova.apache.org>>
> > Subject: [DISCUSS] New Information Architecture for Cordova Website
> >
> > Hi everyone!
> >
> > As a part of the task of improving the Cordova documentation, we came u=
p
> > with a new Information Architecture for the website. The current
> > architecture was not very comprehensive and lacked a well-defined
> structure
> > which made the documentation difficult to follow and find for people.
> Also
> > we decided to add some new content based on the customer feedback from
> our
> > website survey.
> >
> > New articles to be added:
> >
> > Debug and Test (for both apps and plugins)
> > Publish (app to the appstore for all platforms)
> > Automate Tasks (tips to use tools like grunt, gulp and uglify with
> Cordova)
> > Register with NPM
> > Sample Apps (section containing some sample apps built on Cordova)
> >
> > This is the proposed new IA:
> >
> >
> > =C2=B7         Overview
> >
> > =C2=B7         Create apps
> >
> > o    Create your first app
> >
> > o    Develop for platforms
> >
> > o    Manage versions and platforms
> >
> > o    Debug and test
> >
> > o    Automate Tasks
> >
> > o    Store data
> >
> > o    Manage privacy
> >
> > o    Manage security
> >
> > o    Whitelisting
> >
> > o    Publish
> >
> > o    Reference
> >
> > =C2=A7  Config.xml
> >
> > =C2=A7  Events
> >
> > =C2=A7  Plugins
> >
> > =C2=A7  CLI
> >
> > =C2=A7  Hooks
> >
> > =C2=B7         Create plugins
> >
> > o    Create a plugin
> >
> > o    Register with NPM
> >
> > o    Develop for platforms
> >
> > o    Use Plugman
> >
> > o    Debug and test
> >
> > o    Reference
> >
> > =C2=A7  Plugin.xml
> >
> > =C2=B7         Embed Cordova in native apps
> >
> > =C2=B7         Sample Apps
> >
> >
> >
> > We also did a document scrub and tried to figure out the articles which
> > need to be modified or updated with the current information and plan to
> > work on them. Some of these needs to be converted into proper reference
> as
> > seen in the IA.
> >
> > Here is the discuss proposal:
> >
> > https://github.com/cordova/cordova-discuss/pull/31
> >
> > Please give feedback or let us know if you would like to help with this
> > task.
> >
> > -Raghav
> >
> >
> >
>

--001a113988d204d7180526a437af--