cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andrey Kurdumov <kant2...@googlemail.com>
Subject Re: [DISCUSS] Docs improvements
Date Thu, 06 Aug 2015 16:46:11 GMT
Here first try:

http://cordovadocs.azurewebsites.net/en/edge/index.html
http://cordovadocs.azurewebsites.net/es/edge/index.html
http://cordovadocs.azurewebsites.net/ru/edge/index.html

Now it is has splitted lang and version + display message when you see not
latest version. Latest version is not only edge, but also latest separate
version, so message appear only if see 5.0.0 in English and 3.4.0 in
Spanish.


2015-08-06 4:24 GMT+06:00 Victor Sosa <sosah.victor@gmail.com>:

> 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