Message-ID: <gh-pgjdbc-pgjdbc-4075-c4500593618@github.com>
From: "vlsi (@vlsi)" <noreply+vlsi@github.com>
To: "pgjdbc/pgjdbc" <noreply+pgjdbc-pgjdbc@github.com>
Date: Wed, 20 May 2026 16:45:42 +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: 4500593618
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-4500593618
Content-Type: text/plain; charset=utf-8

PR update for reviewers:

## Doc-diff tool added

The index at https://vlsi.github.io/pgjdbc/_doc-diff/ lists every documentation page tagged as new, adapted, or migrated. On any page, the Diff button (bottom-right corner) toggles inline highlighting that color-codes the content: new material vs prose carried over from a prior source. From there you can navigate to the original page to compare.

<img width="692" height="621" alt="doc diff for the new website" src="https://github.com/user-attachments/assets/0bc734fe-1b50-4592-b564-1b662f2ca377" />

## Discoverability of reWriteBatchedInserts

Picked up from [external feedback on Twitter](https://x.com/asm0di0/status/2057079999396499917).

Addressed by:
* Moved connection properties to the first card on the Common Tasks grid
* Added /documentation/connect/recommended-properties/ for settings worth turning on explicitly that aren't (or can't be) defaults
* Promoted the Reference section higher in the top-level nav