Message-ID: <gh-pgjdbc-pgjdbc-4075-c4519607628@github.com>
From: "vlsi (@vlsi)" <noreply+vlsi@github.com>
To: "pgjdbc/pgjdbc" <noreply+pgjdbc-pgjdbc@github.com>
Date: Fri, 22 May 2026 14:31:05 +0000
Subject: Re: [pgjdbc/pgjdbc] PR #4075: docs: restructure site, compatibility page, changelog-driven releases
In-Reply-To: <gh-pgjdbc-pgjdbc-4075@github.com>
References: <gh-pgjdbc-pgjdbc-4075@github.com>
List-Id: <gh-pgjdbc-pgjdbc.github.com>
X-GitHub-Author-Login: vlsi
X-GitHub-Comment-Id: 4519607628
X-GitHub-Comment-Type: issue_comment
X-GitHub-Issue: 4075
X-GitHub-Repo: pgjdbc/pgjdbc
X-GitHub-Type: comment
X-GitHub-Url: https://github.com/pgjdbc/pgjdbc/pull/4075#issuecomment-4519607628
Content-Type: text/plain; charset=utf-8

I have updated the PR description to address the concern that the diff size makes review hard.

Of the 13.8k added lines, the review-heavy portion is ~5.6k of prose across ~40 pages. The rest is doc-tools code, Hugo templates, SCSS, JS, and seed data, exercised by tests, the build, and the preview rather than read line by line.

If anyone has 15 minutes, picking a single page from https://vlsi.github.io/pgjdbc/documentation/ and commenting on what reads off (technical issues, awkward phrasing, broken links, confusing structure) would be very helpful. No deep JDBC context is needed for prose feedback.