On 03.10.22 09:39, samay sharma wrote:
9f5be26c1215 meson: Add docs for building with meson
I do like the overall layout of this.
The "Supported Platforms" section should be moved back to near the end
of the chapter. I don't see a reason to move it forward, at least
none that is related to the meson issue.
Agreed that it's unrelated to meson. However, I think it's better to
move it in the front as it's generally useful to know if your platform
is supported before you start performing the installation steps and get
stuck somewhere.
The way it is currently organized is that 17.2 says
"In general, a modern Unix-compatible platform should be able to run
PostgreSQL. The platforms that had received specific testing at the time
of release are described in Section 17.6 below."
So basically, it says, don't worry about it, your platform is probably
supported, but check below if you are interested in the details.
I don't see a reason to turn this around.
Do you think I should submit that as a separate commit in the same
patch-set or just move it out to a completely different patch submission?
The changes to the "Getting the Source" section are also not
appropriate for this patch.
Given that many developers are now using Git for downloading the source
code, I think it makes sense to be in the Getting the source section.
Also, meson today doesn't cleanly build via the tarballs. Hence, I added
it to the section (and patchset).
Section 17.3 already contains a link to section I.1 about using Git.
Do you think I should move this to a different patch?
If you wanted to pursue these changes, then yes, but I think they are
not clear improvements, as mentioned above.
I suggest focusing on getting the actual meson documentation finished
and then considering polishing the overall flow if desired.