Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Content clarification request/comments #344

Open
wutaomsft opened this issue Aug 12, 2022 · 2 comments
Open

Content clarification request/comments #344

wutaomsft opened this issue Aug 12, 2022 · 2 comments
Assignees
Labels
Health Triaged Triaged within product health

Comments

@wutaomsft
Copy link

This document is overall informational; Thanks! The following are suggestions for improvement.

  1. Explain what maximum means. The document does not explain the definition of "maximum". According to https://www.youtube.com/watch?v=kj2TcMlvWgk, "maximum" is the threshold that "active" servers + "actual standby" servers will not exceed. These concept and relation are important and should be included in the document.
  2. Be consistent in naming - e.g., use "maximum" throughout the document, instead of "max".
  3. Try to avoid using different words when referring to the same concepts. For example, "minimum" is not a term defined in the document but used. Suggest using "Target Standby Floor" instead. Similarly, suggest removing the mentions of "thresholds".
  4. Would be great to explain the relation between default, scheduled and dynamic with a little more details. For examples, is "default" method required even when one has selected "scheduled" standby? Does "dynamic" replace "default" if existed? These may be obvious if one has explored the UI, but would be great to cover them in the documentation too.
  5. Would be great to represent the product-specific terms differently, either in a different font or italic/bold etc.

Thanks for looking into these!


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

@dsayed-msft
Copy link
Contributor

Assign to @natashaorie

@Jeffrey-Shi
Copy link
Contributor

Doc update in progress.

@whenslunch whenslunch removed their assignment Nov 15, 2023
@josehcr8326 josehcr8326 added the Health Triaged Triaged within product health label Nov 20, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Health Triaged Triaged within product health
Projects
None yet
Development

No branches or pull requests

6 participants