cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Carlos Santana <csantan...@gmail.com>
Subject Re: [DISCUSS] Docs improvements
Date Wed, 05 Aug 2015 21:25:06 GMT
+1 Andrey

On Wed, Aug 5, 2015 at 2:27 PM Steven Gill <stevengill97@gmail.com> wrote:

> Do it!
>
> On Wed, Aug 5, 2015 at 8:55 AM, Brian LeRoux <b@brian.io> wrote:
>
> > Sgtm!
> > On Wed, Aug 5, 2015 at 6:05 AM Andrey Kurdumov <kant2002@googlemail.com>
> > wrote:
> >
> > > Hi all,
> > >
> > > I want to made small improvements to the current version of Docs
> > meanwhile
> > > Dmitry Blotsky working on Jekill. Want do discuss proposed changes
> before
> > > implementing them.
> > >
> > > My ultimate goal is to be able publish each version of docs/language
> > > independently. I want faster releases for fixes in translation and
> docs,
> > > and be able fix older docs too.
> > > Please correct me if this is not possible with existing infrastructure.
> > >
> > > Here list of things:
> > > 1. Separate version dropdown on two parts. Language and version. Right
> > now
> > > if you try select non English version you have to scroll over English
> > > versions a lot.
> > > 2. Provide warning about not latest documentation (Using JS) Will put
> > > current version in the docs and check some JSON fiels which will list
> all
> > > versions per language.
> > > 3. Provide No Javascript version of langauge selector checkboxes.
> > > 4. Create new source file for language TOC.md which will be used for
> > > generating left sidebar in the existing docs design. So far, that TOC
> > would
> > > duplicate Overview page as it is now, but want to improve it further
> > later
> > > on. That's breaking change which affects older docs, so I will create
> > such
> > > TOC files for these old docs too, and verify that existing output would
> > be
> > > exactly the same as it is now.
> > >
> > > To implement that I want to create new shared area on the website
> > > `docs/common` folder and `docs/<lang>/common` folder. That folders will
> > > contains
> > > a) `docs/common/langdata.json` - JSON with list of languages + latest
> > > version per language
> > > b) `docs/ru/versionselector.html` - HTML file where use could change
> > > language or version when JS is disabled in browser.
> > >
> > > I extremely want create 1 and 2 before next release. That's rather
> small
> > > changes, but need community agreement on implementing that.
> > >
> >
>

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