Asciidoc specification

[jm.ta...@gmail.com]

I know that there is an Eclipse project and an ongoing specification.

Is there any link to any preliminary or draft specification?

[Matthew Peveler]

My understanding is that the current specification is just "whatever asciidoctor specifies / does", and that a formal specification is still in the works. There is https://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang to track work on an official spec, but there's not been any updates there for 8 months.

[Dan Allen]

The specifically is currently defined by the initial contribution, which is the AsciiDoc Language docs hosted at https://docs.asciidoctor.org/asciidoc/latest/ It's not "whatever asciidoctor specifies / does", but rather what's written in those docs. (However, where there are gaps, we do currently look at the implementation to fill in those details as is necessary. Translating the details into words is still a work in progress).

We plan to re-import the initial contribution into the https://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang repository since it has received significant updates since it was first imported (see https://github.com/asciidoctor/asciidoc-docs/blob/main/docs/CHANGELOG.adoc). The repositories got out of sync due to technical issues setting up and configuring the project in Eclipse's GitLab instance. But we are working to reconcile that.

The specification project will build on the information in the AsciiDoc Language docs, though it will be written in a normative style. We haven't yet started that effort since the focus of the AsciiDoc WG so far has been on securing / protecting the AsciiDoc trademark and brand, developing a visual identity for AsciiDoc, relaunching asciidoc.org, setting up new communication channels for the community, and formulating a program plan for the AsciiDoc WG. It has been a ton of work, but work that's crucial to establishing a foundation on which we can build.

You're welcome to participate in this effort to help move it forward. For the time being, I encourage you to join the AsciiDoc WG mailing list (https://asciidoc-wg.eclipse.org/). We'll have information soon about a new communication channel that will make collaboration easier, so stay tuned for that too.

Best Regards,

-Dan

On Wed, Aug 24, 2022 at 6:27 AM jm.ta...@gmail.com <jm.ta...@gmail.com> wrote:

I know that there is an Eclipse project and an ongoing specification.

Is there any link to any preliminary or draft specification?

--
You received this message because you are subscribed to the Google Groups "asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email to asciidoc+u...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/asciidoc/fd8653c2-3bba-456c-bbc6-4b2616625a6fn%40googlegroups.com.

--

Dan Allen (he, him, his) | @mojavelinux | https://twitter.com/mojavelinux