No Place for JEPs

[Andy Goryachev]

Dear fellow developers:

We often create JEPs and JEP-formatted documents as we propose and develop new features.  These help us during the review process and I am sure are of some benefit for application developers as they try to learn the new functionality in depth.  Presently, we've been creating these files in personal repositories, or presented as descriptions for pull requests, see for example [0].

I think there is a value in making these documents a part of the main repository, maybe under /doc-files.  Doing so would help with the review process as the markdown files are both human-readable and easily diff'ed.  Also, I think it might be more convenient to keep them in the same repo as the code, as opposed to the some personal repositories or wikis.

What do you think?

-andy


References

[0] https://github.com/openjdk/jfx/pull/1522
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/openjfx-dev/attachments/20240807/6792e4ba/attachment.htm>