Skip to content

docs: IDP architecture overview, entity design, and meeting notes#8

Merged
arjunmehta-git merged 1 commit into
masterfrom
docs/idp-architecture-and-meetings
May 27, 2026
Merged

docs: IDP architecture overview, entity design, and meeting notes#8
arjunmehta-git merged 1 commit into
masterfrom
docs/idp-architecture-and-meetings

Conversation

@arjunmehta-git
Copy link
Copy Markdown
Member

Adds foundational IDP documentation:

  • Architecture overview with Mermaid diagram showing Backstage component relationships, GitHub, EKS, and S3 integrations
  • Service catalog entity design: ER diagram, entity kinds, required annotations, naming conventions, tier definitions
  • Platform team standup notes (May 5) - sprint status, blockers, action items
  • Blueprint review meeting notes (May 12) - golden path and blueprint decisions

Covers decisions made in issues #2, #3, #4, #5.

- IDP architecture overview with Backstage component diagram
- Service catalog entity design with ER diagram
- Platform team standup notes (May 5)
- Blueprint review meeting notes (May 12)

Signed-off-by: Arjun Mehta <arjunmehta-git@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 27, 2026 06:27
@miacycle
Copy link
Copy Markdown

Architecture doc looks great. One thing: the diagram doesn't show the TechDocs S3 bucket path - the docs go to S3 not directly in Backstage's memory. Worth adding that arrow.

Copy link
Copy Markdown
Member

@sarajkrishnasingh sarajkrishnasingh left a comment

Choose a reason for hiding this comment

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

Entity design doc is exactly what we needed - the annotation table and tier definitions will prevent a lot of back-and-forth in code review. Approving.

@arjunmehta-git arjunmehta-git merged commit 568cb4c into master May 27, 2026
1 check failed
@arjunmehta-git arjunmehta-git deleted the docs/idp-architecture-and-meetings branch May 27, 2026 06:27
@arjunmehta-git arjunmehta-git review requested due to automatic review settings May 27, 2026 06:48
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.

3 participants