This is the home page now: http://ckeditor5.github.io/
And the documentation will be a part of this website. This means that:
- You must be able to open docs from the home page and vice versa.
- The both pieces should look like one website.
- We need to integrate these pieces in terms of the building process.
- We'll need a new skin for JSDocs (TODO).
Ad 1
This can also be derived from 2. – those pages should share the same (or similar) heading. Home page must link to docs and docs to the home page.
Ad 2
Not only should those pages share the menu, but also stylistics. @RyszardB proposed this for the home page:
![ck_landing](https://cloud.githubusercontent.com/assets/156149/18511838/5f63ad42-7a86-11e6-9d8c-441dc7ace52e.png)
The top menu is quite similar (of course colors are totally different, but the rest should be the same – size, fonts, margins, etc.).
To not complicate this too much for now (because we'll be reworking this in the future anyway), I'd propose that:
- On the home page we have 4 links in the menu "Documentation" and the socials "GitHub", "Like Us", "Follow Us" (but I'd consider adding icons there).
- On the documentation page we'll have "Home page" + "Samples" + "Guides" + ...
I'd prefer if we had exactly the same buttons in the menu in both cases, but the above should be easier to develop, because we won't need to think about grouping things.
Also, I'd like to have social buttons also in the documentation part of the website, so perhaps this means that we should convert them to icons without text (to squeeze more in one place).
Ad 3
This simply needs to be developed. Building, linking, pushing to this repo and also backuping the previous version under releases/
directory. The whole script should land in this repo.
Ad 4
This requires a separate ticket. We shouls approach this in two steps – first at least add a header to the existing JSDoc theme and later on work on a brand new theme. I'll report respective tickets.