Posted by markb on Nov 26, 2018; 9:06pm
URL: https://discuss.asciidoctor.org/Example-online-help-created-with-AsciiDoctor-and-Jekyll-tp6514p6620.html

Hi Dan,

The Devoxx conference is for developers who would probably find adoption of an asciidoctor toolchain relatively straightforward. I'm guessing the attendees are mostly are software developers and programming-literate writers who write documents such as Readmes, requirements documents, internal API guides, and technical books.

There are a lot of tech writers who would not know about Devoxx but would attend conferences such as the STC Summit, Lavacon, MadWorld, and WritersUA.  These are the writers I'm referring to when I say few writers have heard of AsciiDoctor. They include English majors writing car manuals and manufacturing processes, Biology majors writing instructions for surgeons using surgical robots, and pharmacology PhDs writing inserts that accompany prescription medicines.

In a recent article, Technical Writing Tools: The Ultimate Choice of 83 Experts (2018 UPDATE) AsciiDoc gets only one, minor mention. The thought leaders cited in the article represent the community of writers that I'd love to see AsciiDoctor break into.

I'm thinking about writing a series of articles to try to help lower the entry barrier for writers who have always used commercial tools and may never have used a text editor. If I do, I'll post an update on this forum.

Again, thanks for all your efforts and the efforts of the whole AsciiDoctor team. I think you're onto something big and I'm excited to see how the whole enchilada toolchain develops.
Best,
Mark