Experimentation: non technical homepage

[ggrossetie]

Current situation

The current homepage introduces a lot of technical details. If you are a technical person, this is good because, you can start right away and download the asciidoctor Gem or checkout the source from GitHub.

On the contrary, if you are a non technical person, you will most likely move on... It's a pity, because we now have "low barriers" tools that are using Asciidoctor. For instance, I think a non technical person can install the Atom editor and the AsciiDoc preview package without too much trouble. Or write some AsciiDoc in Microsoft Notepad 🙈 and then use the Chrome extension.

Proposal

I've removed all the technical details except the source code block in the AsciiDoc syntax example.
The structure of the page is:

• Syntax (AsciiDoc)
• Processor
• Integration

Basically:

1. Syntax = Write
2. Processor = Publish
3. Integration = How do I setup Asciidoctor in the tools that I'm already using / Getting started

Let me know what you think 😉

[ggrossetie]

I think we should also use an illustration to explain what is Asciidoctor, something like:

AsciiDoc syntax comes in, HTML5 comes out, easy!
Credit to OpenDevise for the adoc document in the illustration 👍

[rockyallen]

Same idea, but even simpler. Is there an online editor/preview for the Try-it button?

[ggrossetie]

Why not :) I think we could use http://gist.asciidoctor.org for the "try-it" button even though this application will ask for a GitHub account (but this is not mandatory). Le 13 janv. 2017 5:41 PM, "rockyallen" <[email protected]> a écrit :

…

[image: try2] <https://cloud.githubusercontent.com/assets/5837117/21937211/4aed9dbe-d9ae-11e6-98ce-6de5d5e92f6a.png> Same idea, but even simpler. Is there an online editor/preview for the Try-it button? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#646 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAUV3Bmid0DHegBOl1RB3hAvIEizqsI7ks5rR6kvgaJpZM4Lir-K> .

[rockyallen]

This would be good opportunity to improve navigation and make it feel more like an integrated website:

1. Keep the top bar (the one in black) fixed at the top of the screen in all pages and documents.
2. Turn "Asciidoctor" on the left into a crumb trail:

Asciidoctor (=home page)
Asciidoctor - News
Asciidoctor - docs
Asciidoctor - docs - Installation
Asciidoctor - docs - User guide
Asciidoctor - docs - Migration guide
etc