Skip to content

docs: document field name conventions for package fields - #1246

Open
roshan13014 wants to merge 2 commits into
elastic:mainfrom
roshan13014:docs/field-name-conventions
Open

docs: document field name conventions for package fields#1246
roshan13014 wants to merge 2 commits into
elastic:mainfrom
roshan13014:docs/field-name-conventions

Conversation

@roshan13014

Copy link
Copy Markdown

Summary

Documents Elastic Package field-name conventions on the fields name property, aligned with Beats and ECS guidance.

Fixes #426.

Change

  • Expand fields.spec.yml name description with ECS preference + Beats/ECS naming rules and links
  • Changelog entry under 3.7.0-next

Scope

Docs-only. No validation/pattern changes.

Notes

AI-assisted; reviewed against Beats event-conventions and ECS guidelines.

@roshan13014
roshan13014 requested a review from a team as a code owner September 8, 2026 05:13
@cla-checker-service

Copy link
Copy Markdown

❌ Author of the following commits did not sign a Contributor Agreement:
99ab3cc, fe4dc5b

Please, read and sign the above mentioned agreement if you want to contribute to this project

custom fields, follow the same naming conventions used by Beats and
ECS:

- Use lowercase letters and snake_case (underscores) to combine words.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

can we just add a referece to the upstream links with the conventions? this way they dont get stale if links are updated

Comment thread spec/changelog.yml
link: https://github.com/elastic/package-spec/pull/807
- description: Document field name conventions (ECS/Beats) on the fields `name` property.
type: enhancement
link: https://github.com/elastic/package-spec/issues/426

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

link should be this pr

Suggested change
link: https://github.com/elastic/package-spec/issues/426
link: https://github.com/elastic/package-spec/pull/1246

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document field name conventions

2 participants