-
Notifications
You must be signed in to change notification settings - Fork 197
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
Documents revision field and adds a description of version field #3313
Conversation
Documentation previews: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Descriptions LGTM! But I don't think we should break the alphabetical order to put related fields next to each other. If the difference between the fields needs to be more explicit, we could add more description or a note, but I'd rather keep the table order consistent and predictable.
That's fair, I'll let the rest of the team weigh in before I change it. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just left two minor suggestions that are totally optional. LGTM overall!
Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't have any additional feedback to add other than what's been posted here. 👍
* documents revision field and adds a description of version field * Update docs/reference/alert-schema.asciidoc Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> * Incorporates Garrett's feedback --------- Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> (cherry picked from commit 7a5d4cb)
…) (#3352) * documents revision field and adds a description of version field * Update docs/reference/alert-schema.asciidoc Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> * Incorporates Garrett's feedback --------- Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> (cherry picked from commit 7a5d4cb) Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
Fixes #3237 and fixes #3116 by adding the new revision field to the alert schema documentation, and adding a description for the version field. I broke the alphabetical order of the fields in the doc to allow these two closely related fields to be next to each other. Let me know if you think any additional details should be included.
Preview: Alert schema