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)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id EA27970C53 for ; Mon, 16 May 2022 18:27:52 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id E09A6200A9 for ; Mon, 16 May 2022 18:27:52 +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)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id D2E352008D for ; Mon, 16 May 2022 18:27:51 +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 A3A2B4367F for ; Mon, 16 May 2022 18:27:51 +0200 (CEST) From: Stoiko Ivanov To: pbs-devel@lists.proxmox.com Date: Mon, 16 May 2022 16:27:27 +0000 Message-Id: <20220516162733.62060-1-s.ivanov@proxmox.com> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.197 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] [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 16:27:53 -0000 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) Stoiko Ivanov (6): docs: silence duplicate label warnings. docs: cleanup and readd command-line-tools docs: use case-matching keys for glossary docs: add certificate-management.rst docs: certificates docs: certs: add screenshots docs/certificate-management.rst | 331 ++++++++++++++++++ docs/command-line-tools.rst | 27 +- docs/command-syntax.rst | 10 + docs/conf.py | 6 +- .../screenshots/pbs-gui-acme-add-domain.png | Bin 0 -> 11638 bytes .../pbs-gui-acme-create-account.png | Bin 0 -> 19818 bytes .../pbs-gui-acme-create-challenge-plugin.png | Bin 0 -> 24795 bytes .../pbs-gui-certs-upload-custom.png | Bin 0 -> 34209 bytes docs/introduction.rst | 21 +- docs/sysadmin.rst | 4 + docs/terminology.rst | 11 +- 11 files changed, 387 insertions(+), 23 deletions(-) create mode 100644 docs/certificate-management.rst create mode 100644 docs/images/screenshots/pbs-gui-acme-add-domain.png create mode 100644 docs/images/screenshots/pbs-gui-acme-create-account.png create mode 100644 docs/images/screenshots/pbs-gui-acme-create-challenge-plugin.png create mode 100644 docs/images/screenshots/pbs-gui-certs-upload-custom.png -- 2.30.2