#828148 asciidoctor-doc: Does not provide Writer's Guide or Quick Reference

Package:
asciidoctor-doc
Source:
asciidoctor
Submitter:
Scott Leggett
Date:
2021-09-11 18:06:06 UTC
Severity:
wishlist
Tags:
#828148#5
Date:
2016-06-25 12:07:28 UTC
From:
To:
Dear Maintainer,

I often refer to the excellent online documentation for Asciidoctor ([0],
[1]) when writing documentation. When I installed asciidoctor and saw
the suggested package asciidoctor-doc, I assumed that this package would
contain copies of this documentation. Instead, asciidoctor-doc contains
API documentation only.

Would it be possible to include the Asciidoc Writer's Guide[0] and Quick
Reference[1] in the asciidoctor-doc package in addition to the API
documentation? This would be very useful for those of us who are just
interested in using asciidoctor as a document processor rather than
interacting with its API.

Regards,
Scott.

[0] http://asciidoctor.org/docs/asciidoc-writers-guide/
[1] http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/

#828148#10
Date:
2017-07-02 09:59:41 UTC
From:
To:
Hi,

Unfortunately (and unless I'm mistaken), those documents don't seem to
be part of the asciidoctor source.

Lucas

#828148#17
Date:
2021-09-11 17:54:00 UTC
From:
To:
Hi,

The documents you request are not part of the program source. They are kept in
a separate Git repository at:

https://github.com/asciidoctor/asciidoctor.org

The license chosen is actually DFSG compliant. But we would have to create a
new source package and probably rename the current asciidoctor-doc package into
ruby-asciidoctor-doc and create asciidoctor-doc from the above Git sources. The
whole thing requires some work. Contributions welcome :)

Regards, Daniel

#828148#20
Date:
2021-09-11 17:54:00 UTC
From:
To:
Hi,

The documents you request are not part of the program source. They are kept in
a separate Git repository at:

https://github.com/asciidoctor/asciidoctor.org

The license chosen is actually DFSG compliant. But we would have to create a
new source package and probably rename the current asciidoctor-doc package into
ruby-asciidoctor-doc and create asciidoctor-doc from the above Git sources. The
whole thing requires some work. Contributions welcome :)

Regards, Daniel