[pve-devel] [PATCH docs v3 1/1] ha: add documentation about ha resource affinity rules

[Daniel Kral]

On Tue Jul 8, 2025 at 6:08 PM CEST, Shannon Sterz wrote:
> On Fri Jul 4, 2025 at 8:20 PM CEST, Daniel Kral wrote:
>>  [[ha_manager_rule_conflicts]]
>>  Rule Conflicts and Errors
>>  ~~~~~~~~~~~~~~~~~~~~~~~~~
>> @@ -774,6 +860,43 @@ Currently, HA rules are checked for the following feasibility tests:
>>    total. If two or more HA node affinity rules specify the same HA resource,
>>    these HA node affinity rules will be disabled.
>>
>> +* A HA resource affinity rule must specify at least two HA resources to be
>> +  feasible. If a HA resource affinity rule does specify only one HA resource,
>
> nit: get rid of the "does" it makes this already very long and hard to
> parse sentence ven hader to read.

ACK this and all the other inline comments.

I didn't find the time to find better words to describe these
properties, but I'll happily accept any suggestions for improvements.

My hope is that most of them (which are not constrainted by the
implementation but the nature of the problem) are intuitive enough
without reading the documentation (for example: cannot keep 2+ ha
resources together and separate at the same time) so that users will
either not run into them that often or the error messages make it clear
enough.