Skip to content

Update documentation to fit mdx spec #1401

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

Merged
merged 2 commits into from
Jul 30, 2021

Conversation

bmorelli25
Copy link
Member

@bmorelli25 bmorelli25 commented Jul 29, 2021

What does this PR do?

Our new documentation system doesn't support the following characters unless they're smushed inside backticks: <, >, {, and }. This PR updates eight packages that contain syntax incompatible with mdx.

I'm going to be honest, I have no idea if I can just edit field.yml files like I did -- so please let me know if I need to go about this differently. To create this PR I updated each package's field.yml and/or _dev/build/docs/README.md file, then ran elastic-package build followed by elastic-package check.

Checklist

  • I have added an entry to my package's changelog.yml file.

Related issues

Closes #1400

Follow-ups

Eventually, it'd be awesome if we could add rules to automatically escape <, >, {, and } -- similar to what I see being done in elastic/elastic-package#451.

@bmorelli25 bmorelli25 added the enhancement New feature or request label Jul 29, 2021
@bmorelli25 bmorelli25 self-assigned this Jul 29, 2021
@elasticmachine
Copy link

elasticmachine commented Jul 30, 2021

💚 Build Succeeded

the below badges are clickable and redirect to their specific view in the CI or DOCS
Pipeline View Test View Changes Artifacts preview preview

Expand to view the summary

Build stats

  • Start Time: 2021-07-29T23:02:20.600+0000

  • Duration: 67 min 32 sec

  • Commit: 7b891c7

Test stats 🧪

Test Results
Failed 0
Passed 637
Skipped 0
Total 637

Trends 🧪

Image of Build Times

Image of Tests

@@ -62,7 +62,7 @@
description: The kind of resource that owns this job (eg. "CronJob")
- name: is_controller
type: keyword
description: Owner is controller ("true", "false", or "<none>")
description: Owner is controller ("true", "false", or `"<none>"`)
Copy link
Member Author

Choose a reason for hiding this comment

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

After asking around and doing some research, I'm pretty sure I need to make this change here: https://github.com/elastic/beats/blame/master/metricbeat/module/kubernetes/state_job/_meta/fields.yml/#L75

And then do something with the import-beats script. What that something is, I'm still not sure 😅

Copy link
Contributor

Choose a reason for hiding this comment

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

The import-beats script is supposed to be used only once for the initial import. Later on we apply changes only in integrations (risk of diverging between both parties is accepted).

Copy link
Member Author

Choose a reason for hiding this comment

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

Aha! Thanks

Copy link
Contributor

@mtojek mtojek left a comment

Choose a reason for hiding this comment

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

Ship it, please :)

@bmorelli25 bmorelli25 merged commit 9b379b1 into elastic:master Jul 30, 2021
@bmorelli25 bmorelli25 deleted the fix-docs-syntax branch July 30, 2021 13:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Broken documentation syntax in mdx
3 participants