Skip to content

docs: operations section#3282

Open
csviri wants to merge 6 commits intomainfrom
operations
Open

docs: operations section#3282
csviri wants to merge 6 commits intomainfrom
operations

Conversation

@csviri
Copy link
Copy Markdown
Collaborator

@csviri csviri commented Apr 8, 2026

No description provided.

csviri added 2 commits April 8, 2026 16:07
Signed-off-by: Attila Mészáros <a_meszaros@apple.com>
Signed-off-by: Attila Mészáros <a_meszaros@apple.com>
Copilot AI review requested due to automatic review settings April 8, 2026 15:30
@openshift-ci openshift-ci bot requested review from metacosm and xstefank April 8, 2026 15:30
@csviri csviri linked an issue Apr 8, 2026 that may be closed by this pull request
Signed-off-by: Attila Mészáros <a_meszaros@apple.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Introduces a new Operations documentation section and reorganizes existing content by moving MDC logging documentation into that section while refocusing the former “Observability” page on metrics.

Changes:

  • Added an Operations section with new pages for Helm chart usage and logging/MDC.
  • Removed MDC logging content from observability.md and renamed that page’s title to “Metrics”.
  • Updated documentation landing page navigation and adjusted page weights for ordering.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
docs/content/en/docs/documentation/operations/_index.md Adds the Operations section landing page.
docs/content/en/docs/documentation/operations/helm-chart.md Documents the generic Helm chart and how to configure/use it.
docs/content/en/docs/documentation/operations/logging.md Adds dedicated logging/MDC documentation (moved out of the old page).
docs/content/en/docs/documentation/observability.md Removes MDC logging section and shifts page identity toward metrics.
docs/content/en/docs/documentation/configuration.md Adjusts nav weight to reflect the updated sidebar ordering.
docs/content/en/docs/documentation/_index.md Updates the top-level documentation navigation to point to Operations.

Comment on lines +12 to +20
| MDC Key | Value added from primary resource |
|:---------------------------|:----------------------------------|
| `resource.apiVersion` | `.apiVersion` |
| `resource.kind` | `.kind` |
| `resource.name` | `.metadata.name` |
| `resource.namespace` | `.metadata.namespace` |
| `resource.resourceVersion` | `.metadata.resourceVersion` |
| `resource.generation` | `.metadata.generation` |
| `resource.uid` | `.metadata.uid` |
Copy link

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

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

The table rows start with || instead of a single |. Many Markdown renderers (and Hugo Markdown configurations) expect | ... | ... | and may not render this as a table. Use a single leading pipe per row (e.g., | MDC Key | ... |) for consistent rendering.

Copilot uses AI. Check for mistakes.
Comment on lines +31 to +39
| MDC Key | Value from Resource from the Event |
|:-----------------------------------------------|:-------------------------------------------------|
| `eventsource.event.resource.name` | `.metadata.name` |
| `eventsource.event.resource.uid` | `.metadata.uid` |
| `eventsource.event.resource.namespace` | `.metadata.namespace` |
| `eventsource.event.resource.kind` | resource kind |
| `eventsource.event.resource.resourceVersion` | `.metadata.resourceVersion` |
| `eventsource.event.action` | action name (e.g. `ADDED`, `UPDATED`, `DELETED`) |
| `eventsource.name` | name of the event source |
Copy link

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

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

Same issue as above: || is non-standard for Markdown tables and may break rendering. Switch these rows to start with a single |.

Copilot uses AI. Check for mistakes.
csviri and others added 3 commits April 8, 2026 17:40
Signed-off-by: Attila Mészáros <a_meszaros@apple.com>
Signed-off-by: Attila Mészáros <a_meszaros@apple.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
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.

Operations section in Docs

2 participants