Deprecate Jekyll-based template with an Awestruct/Antora equivalent

[jeffrey-chongsathien]

Given the following, it seems like driving people towards a Jekyll-based solution is a red herring.

1. The AsciiDoctor/AsciiDoc documentation seemingly uses Awestruct and Antora, as implemented in https://github.com/asciidoctor/asciidoctor-docs-ui
2. The jekyll-asciidoc plugin seems to be inactive, probably due to not being used for the AsciiDoctor/AsciiDoc site.

[jeffrey-chongsathien]

An even better option would be to depreciate this quickstart by arching the repo and redirecting people to the Just the Docs Jekyll theme instead.

https://github.com/just-the-docs/just-the-docs

• The styling is far better.
• It is more useful for general documentation than a blog.
• The usage documentation is better.
• It's less complex than the AsciiDoctor documentation content infrastructure.

[mojavelinux]

The AsciiDoctor/AsciiDoc documentation seemingly uses Awestruct and Antora, as implemented in asciidoctor/asciidoctor-docs-ui

That is not true. It is using Antora, which is a purpose-built site generator for use with AsciiDoc content. See https://github.com/asciidoctor/docs.asciidoctor.org#documentation-structure

[jeffrey-chongsathien]

Missing the point really. I've used the Just the Docs project template for my own project and recommend it as the better template to start from, hence this ticket.

It's inefficient to have two templates that have the same purpose when one would do, particularly with regards to fixing issues/making improvements, as I've just submitted:

just-the-docs/just-the-docs-template#65

[jeffrey-chongsathien]

Just on the Awestruct factual correction that's irrelevant to this ticket, doesn't this README repeatedly mention Awestruct?

Regardless, my point was only just the benefits of aligning to the same technologies - if Awestruct is 'official', try to use it as much as possible, instead of a mix of Aewstruct and Jekyll. That's easier to do the fewer quickstart project templates there are to maintain, hence the suggestion to drop this one as just direct people to the Just the Docs project template.

[mojavelinux]

I did not miss your point. I was just clarifying that the docs site does not use Awestruct. The main site still does, but that is not something we are focusing on changing right now as our attention is on more pressing matters.