<div dir="ltr"><div>Hi,</div><div><br></div><div>On Friday I merged to master the branch for LP#1848524, which adjusts the Evergreen documentation to use the Antora site builder.  There are some implications that developers should be aware of:</div><div><br></div><div>- The docs/RELEASE_NOTES* convention is not affected by the shift to Antora. (At least, not yet; I could imagine that we might end up choosing to fold the release notes into the Antora-built manual.)</div><div>- Similarly, docs/TechRef has been left alone, other than moving a couple stray adoc files there.</div><div>- Otherwise, documents were moved (roughly speaking) from docs/foo/* to docs/modules/foo/pages/*</div><div>- docs/topics/ contains an example of a topic-specific manual (for acquisitions, in this case) that references a set of sections in the core manual</div><div>- docs/README.adoc explains how to build the Antora site, while <a href="http://generate_docs.pl">generate_docs.pl</a> automates most of it</div><div>- The new docs/ layout was not backported to rel_3_5 and earlier, so any devs handling commits that include documentation should take note if they backport such patches.<br></div><div>- There were some changes to the AsciiDoc markup conventions we use. Hopefully Blake and DIG can expand on what I'm about to write, but the most noticeable ones are:</div><div><br></div><div>* Change the headings from</div><div><br></div><div>Heading 1</div><div>========</div><div><br></div><div>to</div><div><br></div><div>= Heading 1 =</div><div><br></div><div>Rather than using "~~~", "^^^^", etc., adjust the number of equals signs to control the heading's level.<br></div><div><br></div><div>* Adding ":toc:" below the top heading of each file<br></div><div>* For references, use<br></div><div><br></div><div>xref:reports:reporter_folder.adoc#reporter_creating_folders[Creating Folders].</div><div><br></div><div>rather than</div><div><br></div><div><<reporter_creating_folders,Creating Folders>>.</div><div><br></div><div>Regards,</div><div><br></div><div>Galen<br>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>Galen Charlton<br>Implementation and Services Manager<br>Equinox Open Library Initiative<br>phone:  1-877-OPEN-ILS (673-6457)<br>email:  gmc@equinoxInitiative.org<br>web:  <a href="https://equinoxInitiative.org" target="_blank">https://equinoxInitiative.org</a><br>direct: +1 770-709-5581<br>cell:   +1 404-984-4366</div></div></div></div></div>