Naval, besides correcting the query logic to be more precise (e.g., with respect to Stakeholder Names), it also seems to me that applying the most recent stylesheet to all of the files in the collection may be the most important next step to get the query service working properly. Consistent with Raines' Rule #7
, doing so would add value in and of itself, regardless of anything else that may or may not be done.
With respect to presentation of query results listings, the hyperlinks should point directly to the files wherever they reside on the Web, via their URLs plus the Identifiers of the relevant elements reveal by the queries. (The search results should not point to the query database itself. It is metadata, not the data/documents themselves.) The hyperlinks should probably open in a new brower tab so that closing it returns users to the previous tab showing the query results.
Because Values & Stakeholders don't have identifiers, the best that probably can be done is to link to the sections in which they appear, like this for Values
. Linking to Stakeholders will be more complex since they may occur at three different levels of the schema: Organization, Goal, and Objective.
However, if the Stakeholder element is queried in conjunction with the Goal/Objective elements, the link should point to the Goal or Objective anyway. Indeed, as far as the hyperlink is concerned, that's probably fine even if only the Stakeholder element is queried by itself.
In that case, however, what should probably be presented in the query results listing is the Description of the Stakeholder &/or perhaps the Role Description. On the other hand, if that's too much complexity to take on at once, it could be deferred for consideration later, on the assumption that it is the descriptions of the goals and objectives that matter most, rather than the descriptions of the stakeholders.
With respect to the current collection, I'd probably leave those files where they are but a) create a new folder at stratml.us/docs
, b) place the newly styled renditions there, and c) use Notepad to semi-automatically update my sitemap listing at https://stratml.us/sitemap.xml
As previously indicated, I'll need to understand why the sitemap listing cannot be used to semi-automatically ingest files into the query service and why doing so may require so much time and effort.
Joe Carmel developed Perl script using the sitemap to create the catalog at https://stratml.us/carmel/catalogsitemap.html
I re-run it periodically to update the catalog. Aside from the opportunity to improve the presentation of the catalog, the biggest problem with the script is that it re-catalogs the entire collection rather than merely the files added or modified since it was last run.