RFR: Remove version numbering

Jesper Wilhelmsson jesper.wilhelmsson at oracle.com
Tue May 26 00:28:22 UTC 2020


> On 26 May 2020, at 02:01, David Holmes <david.holmes at oracle.com> wrote:
> 
> Hi Jesper,
> 
> On 26/05/2020 8:01 am, Jesper Wilhelmsson wrote:
>> Removed release notes and version numbers from all pages. Added a footer which displays file modification date and time
>> instead. The modification time is currently only placed at the bottom of each file, while the version number was
>> present both at the top and at the bottom. This was made on purpose. Please leave a comment if you disagree with that
>> decision. It's a simple makefile change to add it at the top as well.
> 
> Seems okay, but do we want any kind of change history in the documents themselves? I find a last modified date of little use in general.

The complete change history is available in the GitHub repo: https://github.com/openjdk/guide/commits/master

You can also see history for individual files: https://github.com/openjdk/guide/commits/master/src/changePlanning.md

Adding the date was suggested in a previous thread. To me it serves as a way to at least get an impression of how current some information is. In this case it also serves as a tag on the document to refer to in discussions where the version number was previously used. Since the date is kept up to date automatically it's a more convenient way to tag the document.

/Jesper

> 
> Thanks,
> David
> 
>> -------------
>> Commit messages:
>>  - Remove version numbering
>> Changes: https://git.openjdk.java.net/guide/pull/9/files
>>  Webrev: https://webrevs.openjdk.java.net/guide/9/webrev.00
>>   Stats: 158 lines in 20 files changed: 5 ins; 152 del; 1 mod
>>   Patch: https://git.openjdk.java.net/guide/pull/9.diff
>>   Fetch: git fetch https://git.openjdk.java.net/guide pull/9/head:pull/9
>> PR: https://git.openjdk.java.net/guide/pull/9



More information about the guide-dev mailing list