-
Bug
-
Resolution: Unresolved
-
Major
-
None
-
None
-
---
-
---
This is primarily a 'Task' to get rid of low-value uses of the server version in the docs, but there's a small 'Bug' aspect where the dynamically created version in the generated html is actually misleading.
NOTE: it's probably worth discussing this some first on wildfly-dev or Zulip before going beyond the truly "Bug fix" part. See the last bit below for why.
See https://github.com/wildfly/wildfly.github.io/pull/96/files, ignoring the changes in the 37/wildscribe tree, which are not relevant. Also ignore changes in the file timestamps.
The remaining changes are places where the docs use a dynamically generated version, so it's "WildFly 36" in the 36 docs and "WildFly 37" in the 37 docs. (The PR is to fix my screwing that up in the 37 docs.)
Review those places and strongly consider removing the version number bit where the it isn't providing real value vs just saying "WildFly". For sure remove it in places where it results in wrong info, e.g. saying something that's been around for ages is new in WildFly 37. (That's the bug fix part.)
This likely improves readability, and reduces the scope of damage from any future WFLY-20871-like screwup.
Reason to discuss this a bit: We really want to get to where we have stable URLs for our latest docs, rather than having the 'latest' URL of each doc change every quarter. But we'll presumably still publish a complete doc set every release. In this context, there may be a bit more value in having the version number in the text as the person going to the stable URL may be less aware of what version is documented.