public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Daniel Kral <d.kral@proxmox.com>
To: Proxmox VE development discussion <pve-devel@lists.proxmox.com>,
	Alexander Zeidler <a.zeidler@proxmox.com>
Subject: Re: [pve-devel] [PATCH docs v3 1/2] pvesr: update the chapter and bring it into good condition
Date: Thu, 16 Jan 2025 11:03:12 +0100	[thread overview]
Message-ID: <80a47593-91e0-41cc-ad0f-6e9e5e5c5e5f@proxmox.com> (raw)
In-Reply-To: <20250110165807.3-1-a.zeidler@proxmox.com>

On 1/10/25 17:58, Alexander Zeidler wrote:
> Existing information is preserved in a restructured way and usefully
> supplemented.
> 
> * restructure and revise the introduction
> * add subchapter "Considerations"
> * remove the subchapter "Schedule Format" with its one line of content
>    and link where appropriate directly to the copy under "25. Appendix D:
>    Calendar Events". The help button at adding/editing a job links now to
>    the subchapter "Managing Jobs".
> * provide details on job removal and how to enforce it if necessary
> * add more helpful CLI examples and improve/fix existing ones
> * restructure and revise the subchapter "Error Handling"
> 
> Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>
> ---
> v3:
> * adapt the introduction and section "Risk of Data Loss" to provide
>    information about using a shared storage together with storage
>    replication
> * update the CLI example `pvesr update` (*:00 replaces incorrect */00)
> * implement most suggestions from Daniel Kral
> ** update commit message
> ** reword first paragraph of introduction
> ** rename subchapter "Recommendations" to "Considerations"
> ** write "every 15 minutes" to be consistent with UI (and additionally
>     mention that examples from the drop-down list can be modified)
> ** reword the description of the bandwidth limit
> 
> v2: https://lore.proxmox.com/pve-devel/20241218161948.3-1-a.zeidler@proxmox.com/
> * no changes, only add missing pve-manager patch
> 
>   pvecm.adoc |   2 +
>   pvesr.adoc | 411 +++++++++++++++++++++++++++++++++++++----------------
>   2 files changed, 287 insertions(+), 126 deletions(-)

I've read another time through the article and it reads great again - 
nothing to complain from my side ;). The description for why the anchors 
were created could've still landed in the commit message, but that's 
just a tiny nit for me.

Otherwise thanks for the great article, consider this:

Reviewed-by: Daniel Kral <d.kral@proxmox.com>


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel


  parent reply	other threads:[~2025-01-16 10:03 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-01-10 16:58 Alexander Zeidler
2025-01-10 16:58 ` [pve-devel] [PATCH manager v3 2/2] replication: update help button reference Alexander Zeidler
2025-01-16 10:03 ` Daniel Kral [this message]
2025-02-13 14:56 ` [pve-devel] [PATCH docs v3 1/2] pvesr: update the chapter and bring it into good condition Fiona Ebner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=80a47593-91e0-41cc-ad0f-6e9e5e5c5e5f@proxmox.com \
    --to=d.kral@proxmox.com \
    --cc=a.zeidler@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal