<div dir="ltr"><div>Hi,</div><div><br></div><div>To propose an idea for discussion, the Antora work gives us an opportunity for us to (re)consider shipping a pre-built Antora site with each release of Evergreen. Pre-built documentation could be made available via (say) <a href="https://the.evergreen.server/docs/">https://the.evergreen.server/docs/</a>.</div><div><br></div><div>Some pros I see are:</div><div><br></div><div>* This would make it possible for the manual to be completely self-contained.</div><div>* Being able to count on /docs/ being available could inspire the creation of more context-sensitive help.</div><div>* /docs/ could more easily remain in sync with the version of Evergreen that's currently installed.<br></div><div>* Sites that wish to customize their documentation but are not writing it from scratch (or rewriting it wholesale) would be able to do so. Admittedly, that was already possible, but having more of the documentation site-building scripts in Evergreen itself makes a difference.<br></div><div><br></div><div>Some cons include:</div><div><br></div><div>* This would add about 45M to the uncompressed size of the Evergreen tarball. Not huge, but not nothing.</div><div>* Managing customized documentation that's built into an Antora site would have a learning curve.</div><div>* Built-in documentation could make certain features that consortium administrators have intentionally turned off a bit more visible than may be desired.<br></div><div><br></div><div>If we do this, I imagine we'd need at least library settings to control whether built-in documentation or externally-managed documentation is linked to from the staff interface. I could also imagine wanting to make access to /docs/ controlled by a staff permission.<br></div><div><br></div><div>Thoughts? I should note that I'm _not_ proposing that we try to do this for 3.6.0.<br></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>