cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Victor Sosa <sosah.vic...@gmail.com>
Subject Re: [DISCUSS] Docs improvements
Date Wed, 05 Aug 2015 22:24:12 GMT
Yes, please go ahead! :D

On Wed, Aug 5, 2015 at 4:25 PM Carlos Santana <csantana23@gmail.com> wrote:

> +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