Login  Register

Re: Example online help created with AsciiDoctor and Jekyll

Posted by mojavelinux on Nov 26, 2018; 6:05pm
URL: https://discuss.asciidoctor.org/Example-online-help-created-with-AsciiDoctor-and-Jekyll-tp6514p6617.html

I'm happy to say we certainly share the same vision about the impact Asciidoctor can have.

I'd disagree, however, that few writers know about AsciiDoc. That may be true in some circles, as is the case with any tech adoption, but the overall adoption is extremely strong. I was just at Devoxx and just about everyone I ran into is using it in some way. It's used at Red Hat, Couchbase, Elastic, Vaadin, MuleSoft, Neo4j, Fedora, SUSE, and the list goes on and on. I think the adoption curve is right where we can manage it.

Of course, we shouldn't rest on our laurels...and we won't. We have big plans moving forward, and Antora is a key part of it. Instead of just thinking about the processor, or as an add-on to a site generator like Jekyll, we're tackling the whole documentation site publishing enchilada.

I certainly agree the barrier to adoption can be lowered. That's a perennial goal for any technology stack. Lower, lower, lower. But it also helps to have great advocates like yourself spreading the word. Most of the adoption of AsciiDoc (in the Asciidoctor era at least) can be traced back to someone advocating for it. And I am extremely grateful to those people.

Cheers!

-Dan

On Mon, Nov 26, 2018 at 10:18 AM markb [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Thanks for your response, Dan.

I use AsciiDoctor as my default tech writing tool now. It really is a game changer and I think its use will grow in the tech writing community once there's a greater awareness of it. Very few tech writers know about it yet. If the entry barrier to adoption for tech writers was lower, I think AsciiDoctor could outcompete the standard commercial tools, such as Madcap Flare.

I'm going to set up a test site with Antora to see if it can replace Jekyll for me. The website looks very professional and I'm excited to see what it can do.

Cheers,
Mark




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Example-online-help-created-with-AsciiDoctor-and-Jekyll-tp6514p6616.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML


--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux