Squash Glossary in Beta7 Dev Branch

[tajmone]

First Glossary draft with an initial entry (stropping) and some
commented-out pending entries TBD later on (Closes #54).

Update contents of "§4.2. Words, Identifiers and Names":

• Add "Stropping" sub-section.
• Add stropping anchor.
• Add stropping Index entry.
• Revise and improve contents of this section:
  • More examples.
  • Extra admonitions.
  • Polish text.

Clean-up, polish and update README files in Alan Manual directory.

Referenced Issues: #36, #50, #54, asciidoctor/asciidoctor#3248.

[tajmone]

@thoni56, I've setup the Glossary in the Alan Manual, with a single initial entry (stropping) and various TODO entries commented out.

If you have no objects to the contents changes it introduces (see below) I'd like to squash it into the beta7-prep branch as soon as possible, so we can get rid of the dev sub-branches and carry on with other contents updates — Alan Beta7 is approaching and there are still numerous fixes and updates to take care of before the Manual is on par with the upcoming Beta7.

This commit also introduces some contents changes to §4.2. Words, Identifiers and Names — as agreed, you'll be reviewing any contents changes before they are accepted into Manual.

Once this is merged, we should delete the following work branches:

• beta7-prep_glossary
• beta7-prep_glossary-squash

And then I'd like to polish the AppG-i18n branch (on App. G: Localization) so we can squash that too (some paragraphs must be removed first, for I got wrong a couple of things there), and then I can move on to try and fix some of the pending issues marked as "required" for the Beta7 update.

[thoni56]

As you have already noted and responded to, I had a few minor concerns about words and the introduction of the term "stropping". I'm all for the introduction of a glossary.

So consider the comments and then merge on your own discretion.

[tajmone]

Ok, commit 22078d9 definitely mitigate the presence of the term "stropping" — it's no longer in the section title, and its occurrence was replaced with plain English, except in a couple of side notes which are there for informational purposes.

As for the original idea of moving the "Escaping Single Quotes Inside Quoted Identifiers" note from the section Names Containing Multiple Words , I realized that the new text now clarifies it in the main body of the quoted IDs description, and it might be OK to leave that admonition there — for the context also includes NAME clauses, and has wider implications than just IDs.

We can always change it later if we think is better.

Then, if it's OK with you to merge, I'd squash the new commits with original one, to keep the history unclattered, and then merge...