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

Fix example when processed as asciidoc #116

Merged
merged 1 commit into from
Sep 24, 2018

Conversation

adriansr
Copy link
Contributor

The fields entry example consists of a dictionary surrounded by quotes. This causes problems when the example is used for documentation in asciidoc format, as it is interpreted as an escaped attribute, and the docs generation fails because it cannot find a "key1" attribute.

Fixed by removing the quotes around the example, which isn't perfect because it looks a bit ugly in the generated README.md and CSV formats.

Suggestions welcome.

The `fields` entry example consists of a dictionary surrounded by
quotes. This causes problems when the example is used for documentation
in asciidoc format, as it is interpreted as an escaped attribute, and
the docs generation fails because it cannot find a "key1" attribute.

Fixed by removing the quotes.
Copy link
Contributor

@webmat webmat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the result is fine even in the generated files. Thanks for submitting!

LGTM

@webmat
Copy link
Contributor

webmat commented Sep 18, 2018

I'd like to wait for Nic to chime in after his vacation, though. He's obviously more well versed with the details here.

@ruflin ruflin merged commit 78ad17a into elastic:master Sep 24, 2018
@ruflin
Copy link
Member

ruflin commented Sep 24, 2018

I'm pretty sure we will hit other issues down the road with these but then can use other methods in yaml like using >. Thanks for the fix.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants