model-writtenrun 2954 - may be wrong, links go to the source messages. Commit-by-commit LLM analysis is in the Commits dialog.
Mar - Apr 2024 · 16 entries
- Robert Haas opened the thread by arguing that configuration and SQL-command documentation were buried beneath an overcrowded index, proposing to promote commonly used material and consolidate narrowly focused chapters #1.
- Matthias van de Meent suggested categorizing SQL commands, but Robert favored preserving their alphabetical reference list; Tom Lane suggested visual emphasis, while Robert explored navigation links and a custom landing page alongside structural cleanup #2 #3 #6 #7.
- Daniel Gustafsson supplied a stylesheet change for reference-section numbering, prompting discussion of whether the existing Roman numerals were intentional; no landing of this patch is recorded in the supplied thread #8 #9 #26 #29.
- Andrew Dunstan separately identified the roughly 30,000-line func.sgml as an editing problem and proposed splitting its larger sections into separate source files #10.
- Robert's first consolidation series combined installation documentation, moved disk-usage monitoring into database monitoring, grouped built-in index access methods, and combined the two extension-WAL chapters #12.
- Alvaro Herrera and Tom Lane argued for preserving separate source files behind chapter wrappers, so Robert reworked the index-AM and WAL patches accordingly and added a proposed consolidation of procedural-language chapters #15 #17 #19 #20.
- Alvaro inspected the revised index-AM PDF, and David G. Johnston reviewed all five patches, raising chapter-ordering and introductory-text issues; Peter Eisentraut opposed combining self-contained topics and warned that deeper nesting could produce unwieldy HTML pages #22 #24 #28 #47.
- The broader discussion considered a developer appendix, moving reference material out of Internals, and reorganizing monitoring views, but these ideas did not become attached implementation patches in this thread #23 #42 #44.
- Robert narrowed the immediate work to disk monitoring, index access methods, and WAL, setting aside the disputed installation merger and procedural-language consolidation and promising a better introduction for the WAL chapter #49.
- The unchanged disk-monitoring and index-AM components of #20 landed separately as f470b5c679 and fe8eaa5442, and Robert then submitted the remaining WAL patch with its expanded introduction #50.
- Further chapter consolidation stalled on HTML pagination: Robert confirmed that demoting whole chapters produced excessively long pages and investigated variable chunk depth or a custom landing page without settling an implementation #51 #52 #53.
- Peter approved the revised WAL patch for PostgreSQL 17, and Robert committed #50 unchanged as 09d9800e52 #55 #57.
- jian he developed a seven-section extraction of func.sgml, while Andres Freund proposed generating function signatures from catalog metadata; Tom Lane and Corey Huinker raised concerns about descriptions and catalog completeness, and Bruce Momjian suggested validation instead #56 #58 #59 #60 #62.
- That discussion exposed inconsistent function-signature markup, leading Dagfinn Ilmari Mannsåker to submit an independent optional-parameter cleanup; jian he checked its HTML output, and Corey Huinker reviewed it and discussed more readable nesting and caller-oriented variadic notation #63 #67 #68 #69 #70 #71.
- jian he posted seven extraction patches for func.sgml, then replaced the bulky diffs with a Python-driven splitting workflow and a small entity-declaration patch to make the transformation easier to review #73 #75 #81.
- Corey proposed finer-grained files and incremental moves, but Andrew Dunstan and Tom Lane favored one file per first-level section because function documentation can be noncontiguous and benefits from surrounding context; subsequent discussion favored a func subdirectory #74 #76 #77 #78 #82 #83 #85 #87.
Jul - Nov 2024 · 3 entries
- jian he expanded the splitting workflow to all first-level sections under func/, then revised the companion script's validation and hardcoded-line handling through September while resending the same SGML catalog patch; no commit of this splitting work is recorded here #88 #89 #91.
- jian he also revived Ilmari's optional-parameter patch, rebasing it and converting the remaining nested ellipsis brackets while explicitly retaining Ilmari's authorship; Heikki Linnakangas committed that version unchanged as 0d82970336 #92 #93.
- At the thread's close, the three chapter consolidations and optional-parameter cleanup had landed, while file splitting and the broader restructuring remained unfinished; Heikki and Ilmari also left brackets in unnest's return-value description because DocBook rejects <optional> inside <returnvalue> #93 #94.