Packaging and deploying applications

Red Hat built the 'Packaging and deploying applications' guide on 10/16/2019. The PDF and HTML versions are attached here:

• GettingStarted_RHRBuild_10:16:2019.zip

• GettingStarted_RHRBuild_10:16:2019.pdf

We need to determine if there's a better way to display pom.xml, server.xml, SystemReadinessCheck.java, and SystemLivenessCheck.java. Right now, they're included in the middle of the text, and some of them are included multiple times. We could try including them at the end of the guide in some sort of appendix. Then, each reference to one of these files/classes could link down to the appropriate file in the appendix section of the guide. This is assuming that the instances of each file are all the same. Restructuring the guides into this appendix/linking format could be a good starting point for usability testing to determine whether the linking would involve too much movement up and down the page.

It also appears the legal notice needs to be updated, but that may have already been addressed indirectly when we updated the legal notice for the docs.

Start by reviewing the attached PDF and HTML guide, comparing every occurrence of pom.xml, server.xml, SystemReadinessCheck.java, and SystemLivenessCheck.java. Check whether the repeated examples are identical, then evaluate an appendix with links and verify whether the legal notice still needs updating; done means the guide structure and legal notice are resolved.