-
Notifications
You must be signed in to change notification settings - Fork 338
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
Single-sourced content for cloud and cloud icon #1815
Single-sourced content for cloud and cloud icon #1815
Conversation
@nrichers you can use Like @bmorelli25 said, I think the warning about being unable to generate a header link is because the heading is in the shared file, not in the book:
I'm sure we can adapt that to work with shared-reuse snippets like this that we want to include in the main docs repo, if we decide that we want to keep the headers in the shared content, rather than everywhere that content is used. |
Excellent suggestion, thank you! I changed to using
It turned out to be caused by my use of a delimited block, which could cause issues if you were already inside of one when imbedding the file or if you were inside a |
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.
Tested the piece I need, and it LGTM
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.
LGTM
This PR:
Moves the various cloud attributes into a separate section to make them easier to spot:
Adds some standard lead-in text you can use to point people to our Elasticsearch Service (
:ess-leadin:
^^)Adds new cloud icons for ECE and ESS that anyone can use to indicate if something is supported on cloud
The content in this PR isn't intended to be the final say, but rather to create something different books can imbed now, to be reworked over time. Some improvements we should handle in the future:
--resource=$GIT_HOME/docs/
for every book (or the conf.yaml equivalent)Sample usage for single-sourced content is described in the source files themselves and will also be highlighted in the cloud-first writing guidelines we're working on.