[pve-devel] applied-series: [PATCH v4 docs 0/7] Documenation overhaul chapt. 1.12 to 3.2

Thomas Lamprecht t.lamprecht at proxmox.com
Tue Feb 11 17:42:33 CET 2020


On 2/11/20 9:55 AM, Aaron Lauterer wrote:
> This is the first patch series aimed to overhaul our documentation. The
> main goal is to make it easier to understand and more consistent.
> Therefore the phrasing is changed in a lot of places, sometimes the
> ordering of content as well. I tried to align the source to the 80
> characters per line wherever possible.
> 
> The reason why this first patch series doesn't start at the very
> beginning is because we are not yet happy with few things there.
> 

applied series, but not really happy how you just ignored Stefan's and
my comment about why you change title capitalization in just a single
patch (sys requirements one) to something nowhere else used in the docs..
Fixed that up and made a few general followup patches, renaming the "USB
flash drive" to "Prepare Installation Media" and re-ordering it before
"Using the Proxmox VE Installer" which makes quite more sense.

IMO, a series and months-of-work effort called "overhauling the
documentation" should also care for such details, i.e., do a step backward
and see if the general order, flow, .. is all right and somewhat sound.
As else I'd rather just have "grammar + typo fixes" getting in in continuous
small patches and see bigger effort on expanding the documentation with new
content.

Thanks!

> v3 -> v4:
> fixed some phrasings and minor issues reported on v3
> 
> v2 -> v3:
> rebased on current master
> 
> v1[0] -> v2:
> 
> * incorporating suggestions received
> * moved line length and white space fixes to separate patch
> 
> [0] https://pve.proxmox.com/pipermail/pve-devel/2019-September/038938.html
> 
> Aaron Lauterer (7):
>   Overhaul Translation
>   Overhaul System Requirements
>   Overhaul Install from USB flash drive
>   Overhaul Sysadmin
>   Overhaul Package Repositories
>   OVerhaul System Software Updates
>   Fix whitespace and line length
> 
>  getting-help.adoc            |   9 +-
>  howto-improve-pve-docs.adoc  |   4 +-
>  pve-installation.adoc        |  14 ++--
>  pve-package-repos.adoc       | 154 ++++++++++++++++++-----------------
>  pve-system-requirements.adoc |  75 +++++++++--------
>  pve-usbstick.adoc            | 109 ++++++++++++-------------
>  sysadmin.adoc                |  40 ++++-----
>  system-software-updates.adoc |  25 +++---
>  translation.adoc             |  37 +++++----
>  9 files changed, 229 insertions(+), 238 deletions(-)
> 





More information about the pve-devel mailing list