While these are definitely required and useful in some circumstances,
artificially breaking paragraphs onto separate lines, to me, reduces
rather than increases readability.
I'm not sure why I added the attribute previously, in
0afd511b9cbc30e9586d388c32c72d4d25ddddaf, but it's not necessary, and
has caused some confusion. Given that, this commit's removing it.
While not strictly necessary, the rename makes it that much clearer for
contributors to know what the file is for and whether it's the correct
one to edit. It also better organised the "advanced usage" files, so
that the file structure is that much more meaningful as well. So, a
little bit of work now, to save time later.
It was deleted when the original rST content was migrated to AsciiDoc,
and the .gitignore file had a broad exclusion, which it was caught by.
The exclusion in .gitignore has been fixed as well, in this commit.
This reintroduces it, after converting the content to AsciiDoc.
The names, ordering and indentation of the content was incorrect in the
original version of the navigation file. This commit updates it to
reflect the now deleted index.adoc file, which contained the original
ordering from the sphinx-doc version of the documentation.
Antora implements a specific file and directory structure for
components, which you can find out more about at
https://docs.antora.org/antora/1.1/component-structure/. This commit
reorganises the existing images to follow that structure, as well as
optimises them, so that they're as small as possible, without losing any
quality.
