RFR: Split up monolithic markdown

Magnus Ihse Bursie ihse at openjdk.java.net
Thu Mar 25 01:05:45 UTC 2021


On Tue, 16 Mar 2021 13:46:57 GMT, Magnus Ihse Bursie <ihse at openjdk.org> wrote:

>> Continuing the erroneously placed discussion from PR #46:
>>> I don't mind this change but...
>> 
>> If we want to future-proof this and make it a stable foundation we shouldn't have chapter numbers in the file names. I don't want to rename all chapters just because a new one is inserted or removed somewhere. Also, since we are quite early in the making of this document it's likely that chapters will move within the guide as well.
>
> I thought it was a simple and elegant solution to get the chapters to line up, both when combining them in the make file, and in the IDE when editing them (as long as your IDE sorts files based on name). Again, I don't see renaming as a big problem, maybe that's what makes our opinions differ on this patch.
> 
> But sure, if you really prefer, I can provide another way of telling the build system how to organize the files when combining them.
> 
> Does it sound like a good idea to you to list them in order in a text file?

The world was not ready for this change just yet. :-) Withdrawing PR.

-------------

PR: https://git.openjdk.java.net/guide/pull/47


More information about the guide-dev mailing list