[Doc] Threshold Shedder documentation - need to add documentation on the individual weights

What issue do you find in Pulsar docs?

In https://pulsar.apache.org/docs/next/administration-load-balance#thresholdshedder

1. LocalBrokerData#getMaxResourceUsageWithWeight should be a link or in different font. In addition so should loadBalancerHistoryResourcePercentage and loadBalancerBrokerThresholdShedderPercentage

2. “The weights for each resource are configurable.” - it would be great if the weights were listed or perhaps a link to the relevant section of the reference configuration here https://pulsar.apache.org/docs/reference-configuration/#broker

3. It would be nice to know when to prioritize one weight over another - just some general guidelines

4. “If a broker’s usage is greater than the average usage per broker plus the loadBalancerBrokerThresholdShedderPercentage” Is that percentage an absolute percentage?

e.g. say the % usage is 5% / 1% / 1% for three brokers - comparing 5 vs 1 is a 5x difference or 500% comparing on a relative basis but a 4% on an absolute basis. Can it be clarified which percentage loadBalancerBrokerThresholdShedderPercentage is? Perhaps an example would help?

What is your suggestion?

See above

Do you have any references?

No

Would you like to fix this issue?

Sorry - some of it requires more detailed clarification from someone who knows the load balancer algos in detail.

Note

• I have researched my question.

[frankjkelly]

Awesome - thanks so much @Anonymitaet !

[momo-jun]

@Demogorgon314 can you take a look at this issue? Thank you.