As noted in old Ant build files, it was always a goal to also create PDF versions of manuals like
AJ5 Developer's Notebook,
AJ Programming Guide,
AJ Development Environment Guide,
AJ Problem Diagnosis Guide,
AJ Design Overview (optionally).
As part of #76, we already create two HTML variants from the asciidoc sources, namely HTML multi-page and HTML single-page. This is redundant already, but caters to different user types and documentation usage situations. PDFs would be a third variant. While some users might prefer reading docs in a web browser, others might wish to carry a single file containing all information (incl. images) for a piece of documentation. Using Asciidoctor already because of #76, it would be relatively straightforward to add build steps for PDF generation, even though PDF generation is slow and makes a full build take significantly longer.
Loosely related to #271, it would also be quite easy to add the PDFs to the AspectJ installer, not just to the website.
As noted in old Ant build files, it was always a goal to also create PDF versions of manuals like
As part of #76, we already create two HTML variants from the asciidoc sources, namely HTML multi-page and HTML single-page. This is redundant already, but caters to different user types and documentation usage situations. PDFs would be a third variant. While some users might prefer reading docs in a web browser, others might wish to carry a single file containing all information (incl. images) for a piece of documentation. Using Asciidoctor already because of #76, it would be relatively straightforward to add build steps for PDF generation, even though PDF generation is slow and makes a full build take significantly longer.
Loosely related to #271, it would also be quite easy to add the PDFs to the AspectJ installer, not just to the website.