Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wplcZ-001psm-2G for pgsql-docs@arkaria.postgresql.org; Fri, 31 Jul 2026 11:41:47 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.96) (envelope-from ) id 1wplcY-00Fsc3-1z for pgsql-docs@arkaria.postgresql.org; Fri, 31 Jul 2026 11:41:46 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wpjEr-00FC9t-0c for pgsql-docs@lists.postgresql.org; Fri, 31 Jul 2026 09:09:09 +0000 Received: from mahout.postgresql.org ([2001:4800:3e1:1::227]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1wpjEo-00000001Ew3-268l for pgsql-docs@lists.postgresql.org; Fri, 31 Jul 2026 09:09:08 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=postgresql.org; s=20171124; h=Message-ID:Date:Reply-To:Cc:From:To:Subject: Content-Transfer-Encoding:MIME-Version:Content-Type:Sender:Content-ID: Content-Description:In-Reply-To:References; bh=KRK3raw4S/+GnkZdncCh6t6fzUigVLpgmGs+YJI9Wow=; b=YJw/yuzdZlaaiZQG9sZ669iGTD qtzuegu2r+8lxUBmSOddT6o+LtBqarxkaX6tXOQh3obOK6aLg0SvVhhvzVEzIO9NzNVMqilQz9M4I ZC5sF8WgW/s11tsi2CR6drFdYWjCugmhsADG1T8qYarg4nDTO1BEPQ5P1rUt2c7Xv4nGvBKBAQEWZ spD/S9fx+n8uog/iqkp37MT7uq9cdI4RnaU/v6zv5WHA96FO9o3Jg3B1jVahVm6lHqmULkztIRJDk vulPopKcFa5d4yWnEFJXX+PoT8LAZK3VBgNAxYFPpjHn2qPDQFHEiHlLSJf93GwRupWt/OaAra9Po AiQVMD4A==; Received: from wrigleys.postgresql.org ([2a02:16a8:dc51::60]) by mahout.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wpjEm-003m9x-1Y for pgsql-docs@lists.postgresql.org; Fri, 31 Jul 2026 09:09:05 +0000 Received: from localhost ([127.0.0.1] helo=wrigleys.postgresql.org) by wrigleys.postgresql.org with esmtp (Exim 4.98.2) (envelope-from ) id 1wpjEl-00000009Dbx-0Btj for pgsql-docs@lists.postgresql.org; Fri, 31 Jul 2026 09:09:03 +0000 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Subject: References/Links missing To: pgsql-docs@lists.postgresql.org From: PG Doc comments form Cc: oli.sennhauser@fromdual.com Reply-To: oli.sennhauser@fromdual.com, pgsql-docs@lists.postgresql.org Date: Fri, 31 Jul 2026 09:08:31 +0000 Message-ID: <178548891126.2195444.7376480612463263969@wrigleys.postgresql.org> X-Auto-Response-Suppress: All Auto-Submitted: auto-generated List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/18/warm-standby.html Description: When crawling through this page: https://www.postgresql.org/docs/current/warm-standby.html I found a lot of references missing which makes it exhausting reading and working through the text. Is it worth to take the effort to add more/all references? What are the rules? Only the first occurrence or all occurrences of a keyword? Examples: * synchronous_standby_names: Only the first occurence is referenced (but I am possibly reading other chapters?) * archive_command: Is not referenced in Chapter 26.2.9 (but further up, but I am possibly not reading the other chapter?) * synchronous_commit: Is not referenced at all (https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-SYNCHR= ONOUS-COMMIT) * pg_receivewal: Is not referenced at all (https://www.postgresql.org/docs/current/app-pgreceivewal.html) * pg_backup_stop and pg_backup_start: Is not referenced at all (https://www.postgresql.org/docs/current/functions-admin.html#FUNCTIONS-ADM= IN-BACKUP)