Skip to content

docs: add explanations for Serverless, Members, and Special layers in…#4650

Open
aarya0044 wants to merge 1 commit intocncf:masterfrom
aarya0044:update-docs-landscape
Open

docs: add explanations for Serverless, Members, and Special layers in…#4650
aarya0044 wants to merge 1 commit intocncf:masterfrom
aarya0044:update-docs-landscape

Conversation

@aarya0044
Copy link

Issue

The current Landscape Guide diagram includes a "Serverless" column, a "Members" column, and a bottom-most layer labeled "Special", but there is no accompanying explanation in the documentation.

Since these elements are part of the official diagram, adding descriptions for them would improve clarity, completeness, and usability — especially for new contributors trying to understand the architecture.

Proposed Changes

  • Add a short explanation for the Serverless column (purpose and examples)
  • Add a short explanation for the Members column (who it represents and role)
  • Add a section describing the Special layer (why it exists, what it includes, and how it differs from other layers)

Benefits

  • Makes documentation more complete
  • Helps contributors better understand architecture
  • Improves onboarding for beginners
  • Avoids confusion and assumptions about undocumented sections

Let me know if you'd like me to format the content in a specific style to match the repo.

… Landscape Guide

Signed-off-by: Aarya Dharmadhikari <aaryadharmadhikari9850@gmail.com>
@aarya0044 aarya0044 force-pushed the update-docs-landscape branch from ccf7082 to 2e4947c Compare January 2, 2026 14:04
@aarya0044
Copy link
Author

Hi maintainers 👋
This PR only adds documentation for missing architecture layers.
No changes were made to the .github/workflows/ directory or landscape.yml.
The "Validate landscape.yml" workflow is currently awaiting approval — could you please approve the workflows to run?
Thanks a lot for your support!

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.

2 participants