search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
322 stars 807 forks source link

Experimentation: non technical homepage #646

Open ggrossetie opened 7 years ago

ggrossetie commented 7 years ago

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

asciidoctor-home4

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

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 commented 7 years ago

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

asciidoctor-nutshell

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

rockyallen commented 7 years ago

try2

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

ggrossetie commented 7 years ago

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" notifications@github.com 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 https://github.com/asciidoctor/asciidoctor.org/issues/646#issuecomment-272484185, or mute the thread https://github.com/notifications/unsubscribe-auth/AAUV3Bmid0DHegBOl1RB3hAvIEizqsI7ks5rR6kvgaJpZM4Lir-K .

rockyallen commented 6 years ago

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