Skip to content

[Docs] Replace dead design-doc link in CONTRIBUTING.md - #8286

Open
sameerkrdev wants to merge 2 commits into
layer5io:masterfrom
sameerkrdev:docs/contributing-design-link-8235
Open

sameerkrdev wants to merge 2 commits into
layer5io:masterfrom
sameerkrdev:docs/contributing-design-link-8235

Conversation

@sameerkrdev

@sameerkrdev sameerkrdev commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

Description

This PR fixes #8235

The "Style Guide" section of CONTRIBUTING.md asked contributors to review a "design doc" hosted on Google Docs. That document has been deleted (HTTP 410), so the link is dead.

This replaces it with the Layer5 Designs Figma file, the same link the issue templates and the 404 page already point contributors to as "Layer5 site designs":

  • Before: please review the [design doc](https://docs.google.com/document/d/1rvUZy2_.../edit#)
  • After: please review the [Layer5 site map](https://www.figma.com/file/5ZwEkSJwUPitURD59YHMEN/Layer5-Designs) in Figma to understand how the pages of the website relate to each other and the high-level data flow between them

Notes for Reviewers

  • The pre-commit hook (prettier) also realigned the column padding of the build-variables table in the same file. That's whitespace only, no content changes.
  • npm run check:contributing-versions passes.
  • If you'd prefer to remove the sentence instead of re-pointing it, I'm happy to update the PR.

Signed commits

  • Yes, I signed my commits.

Summary by CodeRabbit

  • Documentation
    • Updated the Style Guide link to the Layer5 site map in Figma and revised its description to identify it as a reference for page relationships and high-level data flow.

The Style Guide section linked to a Google Doc that now returns HTTP 410 (deleted). Point it to the Layer5 Designs Figma file, which the issue templates and the 404 page already reference as "Layer5 site designs".

Fixes layer5io#8235

Signed-off-by: Sameer Kumar <sameerkr.dev@gmail.com>
@coderabbitai

coderabbitai Bot commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: a75e5cfd-2242-457a-8bf0-b0cf141beacd
Commits

Reviewing files that changed from the base of the PR and between 9446210 and a5dfd22.

Files selected for processing: 1
  • CONTRIBUTING.md
Files skipped from review as they are similar to previous changes: 1
  • CONTRIBUTING.md

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 3 remain after this review.

Walkthrough

The Style Guide section in CONTRIBUTING.md now links to the Layer5 site map in Figma and describes it as a reference for page relationships and high-level data flow. The preview-deployment sentence is unchanged.

Changes: Contribution guide update

Layer / File(s) Summary
Update the Style Guide reference
CONTRIBUTING.md
The Style Guide link and description now refer to the Layer5 site map in Figma and its page relationships and high-level data flow.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other · Severity of issue fixed: Low

Suggested reviewers: mahakgupta108

Merge Risk: Minimal · up to a5dfd

The contribution-guide update appears ready to merge after normal checks.

Pre-merge checks: Passed 4
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title "[Docs] Replace dead design-doc link in CONTRIBUTING.md" matches the single change in the changeset. The Style Guide section of CONTRIBUTING.md now links to the Layer5 Figma site map instead…
Linked Issues check Passed Issue #8235 requires the dead design-document link in CONTRIBUTING.md to point to an existing destination. The whole-PR diff replaces the Google Docs URL with the requested Layer5 Designs Figma URL …
Out of Scope Changes check Passed The whole-PR diff contains one line change in CONTRIBUTING.md. The change directly implements issue #8235. The diff contains no unrelated table-formatting changes or other out-of-scope content.
Full details: Title check

Explanation

The title "[Docs] Replace dead design-doc link in CONTRIBUTING.md" matches the single change in the changeset. The Style Guide section of CONTRIBUTING.md now links to the Layer5 Figma site map instead of the deleted design-doc link, as described in the raw summary, linked issue #8235, and PR objectives. The title is specific and names the file and the type of change. The title does not mention the new link's purpose (a site map), but that detail is not needed for the primary change.

Full details: Linked Issues check

Explanation

Issue #8235 requires the dead design-document link in CONTRIBUTING.md to point to an existing destination. The whole-PR diff replaces the Google Docs URL with the requested Layer5 Designs Figma URL and updates the description to explain the site map. The PR description reports that npm run check:contributing-versions passes.

Finishing Touches
Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@github-actions

github-actions Bot commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

🚀 Preview deployment: https://layer5.io/pr-preview/pr-8286/

@rahmanaisha rahmanaisha left a comment

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.

Nice work - this is exactly the fix #8235 asks for, and it is ready to merge.

What works well:

  • The replacement link is the right target, not just a live one: it is the same Layer5 Designs Figma file the issue templates and the 404 page already point contributors to, so CONTRIBUTING.md now agrees with the rest of the repo instead of inventing a new destination.
  • The link text follows the same "Layer5 site designs" naming those pages use, so contributors see one consistent name for it everywhere.
  • The build-variables table reformat is whitespace only - I compared the rows and every variable, value, and description is unchanged - and flagging it in the PR description up front was the right call.

No changes needed. Build, DCO, and triage checks are all green at this head.

Comment thread CONTRIBUTING.md Resolved
Comment thread CONTRIBUTING.md Resolved
…rmatting

Address review on layer5io#8286: describe the Figma link as the Layer5 site map (how pages relate and the high-level data flow) rather than site designs, and revert the whitespace-only realignment of the build-variables table that the pre-commit prettier hook introduced.

Signed-off-by: Sameer Kumar <sameerkr.dev@gmail.com>

This branch has not been deployed

No deployments
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.

[Docs] Replace dead design-doc link in CONTRIBUTING.md

3 participants