From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 139E570D8E for ; Mon, 16 May 2022 19:29:11 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id F0AEB207D1 for ; Mon, 16 May 2022 19:28:40 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id CE306207C3 for ; Mon, 16 May 2022 19:28:39 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 9827543201 for ; Mon, 16 May 2022 19:28:39 +0200 (CEST) Message-ID: <139ce39d-d407-c07e-6e52-de7898f61ab6@proxmox.com> Date: Mon, 16 May 2022 19:28:38 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:101.0) Gecko/20100101 Thunderbird/101.0 Content-Language: en-GB To: Proxmox Backup Server development discussion , Stoiko Ivanov References: <20220516162733.62060-1-s.ivanov@proxmox.com> From: Thomas Lamprecht In-Reply-To: <20220516162733.62060-1-s.ivanov@proxmox.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.019 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record T_SCC_BODY_TEXT_LINE -0.01 - Subject: [pbs-devel] applied: [PATCH proxmox-backup 0/6] docs: cleanup and add certificate docs X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 May 2022 17:29:11 -0000 Am 5/16/22 um 18:27 schrieb Stoiko Ivanov: > while trying to add the certificate documentation I noticed a few > (rather harmless) warnings while running make html > > patches 1-3 address those and are independent of the certificate > documentation (3-6). > > For the certificate docs I took the approach of (semi) automatically > converting the ssl-docs from pmg-docs to rst (asciidoc->docbook (via > asciidoc), docbook->rst (via pandoc)) - the exact commands are > in the commit message of 4/6. > > The mid-term idea here would be to have one single source for the common > docs (system-booting, local-zfs and parts of the certificate > documentation come to mind for now) - since keeping them in multiple > places, but with similar/identical content just means that improvments > don't make it to all copies (or only with quite a bit of manual > vimdiffing by the code-reviewers) > applied, thanks! But replaced the odd image-referencing with just placing them inline, and align to a side plus add an alt text like we do for most others. Also removed a duplicate usage of showing the challenge plugins screenshot.