-
Notifications
You must be signed in to change notification settings - Fork 342
Add Github link support to beta and experimental macros #1705
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
Conversation
We add the `experimental::[]` and `beta::[]` macros to document features that are not yet ready for GA. However, these tags don't currently indicate what steps are needed to get a feature to GA. With these changes, users can include a GitHub issue for the feature in the `experimental::[]` or `beta::[]`. When provided, a concise sentence and link is generated for the issue.
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 think it is worth adding a test in the docbook_compat_spec
file for this too.
Thanks for taking a look @nik9000. While I was rewriting this to pass the Rubocop tests, I decided to add support for |
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 left a small thing that you can change or not. Up to you. Otherwise looks great! Thanks for doing it!
I've grown to really like rspec and find ruby to be "ok". I love rubocop. I like that it feels crazy picky coming from java-land and that it makes me think about problems differently.
We add the
experimental::[]
andbeta::[]
macros to document features that are not yet ready for GA. However, these tags don't currently indicate what steps are needed to get a feature to GA.With these changes, users can include a GitHub issue for the feature in the
experimental::[]
orbeta::[]
. When provided, a concise sentence and link is generated for the issue.Relates to https://github.com/elastic/elasticsearch/issues/51250
Examples
http://test__care-admon-links.docs-preview.app.elstc.co/guide/en/elasticsearch/reference/master/_beta_experimental_macro_examples.html