> On 28 Jun 2024, at 20:40, Peter Eisentraut <pe...@eisentraut.org> wrote:
> If we're going to do it, then I expect that the files are marked up correctly > at all times. I agree with that. I don't think it will be a terribly high bar though since we were pretty much already writing markdown. We already have pandoc in the meson toolchain, adding a target to check syntax should be doable. > Conversely, what's the best that could happen? One of the main goals of this work was to make sure the documentation renders nicely on platforms which potential new contributors consider part of the fabric of writing code. We might not be on Github (and I'm not advocating that we should) but any new contributor we want to attract is pretty likely to be using it. The best that can happen is that new contributors find the postgres code more approachable and get excited about contributing to postgres. -- Daniel Gustafsson