model-writtenrun 5408 - may be wrong, links go to the source messages. Commit-by-commit LLM analysis is in the Commits dialog.
- Peter Smith reported that the System Catalogs table of contents misleadingly placed overview headings alongside individual catalogs and views, and proposed nesting those objects under separate sections #1.
- Peter Eisentraut explained that the chapter originally contained no system views, and Tom Lane proposed a separate System Views chapter, which Peter Smith supported #2 #3 #4.
- Bruce Momjian volunteered to implement the split and initially favored limiting it to development and PostgreSQL 15 to avoid breaking released documentation links; Tom Lane clarified that individual catalog and view URLs should remain unchanged #6 #8 #9 #10.
- Bruce submitted the chapter-extraction patch and rendered output, which Peter Smith inspected and approved #11 #12.
- Peter Eisentraut opposed backpatching the resulting chapter renumbering into released versions and questioned the generic views.sgml filename; Bruce restricted the change to development and PostgreSQL 15, and Tom Lane supplied the accepted system-views.sgml name #13 #14 #15 #16 #17.
- Bruce committed the attached patch with only filename, entity, and path-comment adjustments as 64d364bb39, then announced that it had landed in master and PostgreSQL 15 #11 #18.
- After the commit, Peter Eisentraut questioned grouping all system views together under Internals because they mix catalog-like interfaces with user-facing reporting; Tom Lane agreed and suggested placing user and DBA views nearer their respective documentation #19 #21.
- Peter Smith still preferred the landed organization to the original confusing contents, while Bruce proposed distributing view documentation among chapters covering the relevant tasks #22 #23.
- Bruce posted topical groups for that redistribution, but Isaac Morland requested a comprehensive index; Bruce had not planned one and suggested retaining the existing centralized documentation with links instead #24 #25 #26.
- The thread ended with the chapter split still landed and further organization unresolved: Bruce suggested moving the intact chapter to Server Administration and distinguishing task-essential views from reporting views, without submitting another patch #27 #28.