Added Developer-Notes

Developer-Notes.md

@@ -0,0 +1,37 @@
+# Developer notes
+
+Although Java is a more stable platform than most, it is subject to
+change over time. Here are some notes about futurization:
+
+## Java compiler
+
+Java 9 broke how introspection works. Java 11 gives a deprecation
+warning. Later Java versions may not work using the current
+versions of Spring Boot.
+
+The version of Spring Boot being used is a downstream consequence
+of the version of  joinfaces and the spring boot starter. Presently
+an upgrade is not advised because newer versions remove CDI support
+and thus the code will not compile without additional aid as
+yet undetermined (possibly Weld).
+
+## Primefaces
+
+The version of Primefaces pulled in by the starters is 6.2. The
+production version to date (2022-01) is 10. Version 6.2 is
+perfectly serviceable, but changes will be required if/when
+upgrading. The "listener" keyword on AJAX changes and the icon
+names change as well. The 6.2 release use jQuery icons, not
+Primefaces icons.
+
+### Joinfaces
+
+According to the joinfaces docs, you can override the Primefaces
+theme using joinfaces.primefaces.theme in the ``application.properties``
+file. That is not true for the release in question. The working
+override is ``server.servlet.context-parameters.primefaces.THEME``
+
+It should be noted that webapp context initialization variables,
+once set cannot be changed so there is only a limited time to set
+them. An internal set for Primefaces 4 and later selects the aristo
+theme if not overriden in the correct place.

src/main/resources/META-INF/resources/main.xhtml

@@ -22,11 +22,13 @@
                     </p:inputText>
                 </span>
                 <p:commandButton id="find" value="Find"
+                    icon="ui-icon-search"
                     defaultCommand="true"
                     action="#{adminMainBean.doFind}"
                 />
                 <p:commandButton id="ctlClear" value="Clear"
                     immediate="true"
+                    icon="ui-icon-close"
                     update="form1:searchFor form2:table1"
                     action="#{adminMainBean.ajaxClearList}"
                 />

src/main/resources/META-INF/resources/recipeDetails.xhtml

@@ -45,13 +45,14 @@
                                     columns="2"
                                 >
                                     <p:commandButton
-                                        value="&lt;- Back"
-                                        styleClass="ui-button-arrow-left"
+                                        value="Back"
+                                        icon="ui-icon-arrowthick-1-w"
                                         action="main.jsf"
                                         immediate="true"
                                     />
                                     <p:commandButton
                                         value="Print"
+                                        icon="ui-icon-print"
                                         action="recipePrint.jsf"
                                         styleClass="ui-button-print"
                                         immediate="true"

src/main/resources/META-INF/resources/recipePrint.xhtml

@@ -22,7 +22,8 @@
                 <p:column
                     style="vertical-align: middle; text-align: left; border: none"
                 >
-                    <p:commandButton value="&lt;- Back"
+                    <p:commandButton value="Back"
+                        icon="ui-icon-arrowthick-1-w"
                         style="margin-left: 2em" immediate="true"
                         action="/main.jsf"
                     />