Where to put supplementary docs?

Magnus Ihse Bursie magnus.ihse.bursie at oracle.com
Fri May 23 17:34:27 UTC 2025


On 2025-05-23 02:58, Kim Barrett wrote:

> On 5/21/25 4:18 AM, Andrew Haley wrote:
>> We should allow any reasonable type of document.
>
> What's a "reasonable type of document"? I think there should be 
> restrictions
> on the document format. In particular, binary formats come and go, and we
> should probably avoid such without careful consideration.
>
Maybe the list of "reasonable" documents includes just markdown, pure 
text, pdf, and html (in roughly that order of preference)? Most other 
formats can easily be converted into any of these, and if we encounter 
some kind of document that could not, we can discuss extending the list.

/Magnus



More information about the jdk-dev mailing list