Version numbers in the guide

Iris Clark iris.clark at oracle.com
Thu May 21 04:28:43 UTC 2020


Hi, Jesper.

I don't think the Guide needs version numbers.  This type of documentation should be viewed as continually evolving.  MLA, Chicago, APA and other style guides use an "accessed on #DATE" for on-line references.

If somebody really wants to have some kind of numbering system associated with a particular Guide web page, then a time/date stamp or commit would be reasonable if there is a relatively passive solution to add it.  Perhaps the stamp is added at build time or it is updated when the editor saves changes?  The second choice would lead to differing stamps across the Guide over time, but I don't see that as a problem.

Thanks,
Iris


More information about the guide-dev mailing list