"Installation Quickstart" Content Discussion

[jaredmorgs]

http://asciidoctor.org/docs/user-manual/#installation-quick-start is currently available to create content for.

Use this issue as a tracker for content suggestions, or feel free to provide PRs referencing this ticket to keep track of contributions.

This content is contained in https://github.com/asciidoctor/asciidoctor.org/blob/master/docs/user-manual.adoc

[nicorikken]

What is expected for this feature? Command line package retrieval one liners? Or GUI-based, maybe web browser plugin, or referring to hosted services?

[mojavelinux]

I believe we have a reasonable approach for installation in the Install and Update section of the documentation at https://docs.asciidoctor.org/asciidoctor/latest/install/. We'll never be able to offer a single quick start since the installation procedure varies between operating systems, each which offers its own primary package manager. The best we can do is guide the user towards the instruction that best suits them. (Though I still want to write up the guide for managing gems as proposed in #884).

I do think improvements are still needed, but I'd like to address them in context. If there's a better way to document how to install the RPM, for example, let's focus on improving those docs specifically.