Skip to content

docs: update guestbook contribution process #314

Open
BekahHW wants to merge 2 commits into
mainfrom
feat/update-guestbook-contribution-process
Open

docs: update guestbook contribution process #314
BekahHW wants to merge 2 commits into
mainfrom
feat/update-guestbook-contribution-process

Conversation

@BekahHW
Copy link
Copy Markdown
Contributor

@BekahHW BekahHW commented May 27, 2026

BLOCKER: new process must be merged first

Update instructions to reflect new JSON-based contribution system that eliminates merge conflicts.

Changes:

  • Replace CLI-based process with JSON file creation
  • Add clear field-by-field explanations
  • Include preview command for validation
  • Update merge conflict section (conflicts now rare)
  • Add troubleshooting for common JSON errors
  • Emphasize single-file contribution model

Addresses the new contribution workflow in OpenSource-Communities/guestbook

Description

Related Issues

Mobile & Desktop Screenshots/Recordings

Steps to QA

[optional] What GIF best describes this PR or how it makes you feel?

Update instructions to reflect new JSON-based contribution system that eliminates merge conflicts.

Changes:
- Replace CLI-based process with JSON file creation
- Add clear field-by-field explanations
- Include preview command for validation
- Update merge conflict section (conflicts now rare)
- Add troubleshooting for common JSON errors
- Emphasize single-file contribution model

Addresses the new contribution workflow in OpenSource-Communities/guestbook

Co-authored-by: Cursor <cursoragent@cursor.com>
@BekahHW BekahHW requested a review from adiati98 as a code owner May 27, 2026 16:41
@netlify
Copy link
Copy Markdown

netlify Bot commented May 27, 2026

Deploy Preview for learn-open-source ready!

Name Link
🔨 Latest commit c47da3c
🔍 Latest deploy log https://app.netlify.com/projects/learn-open-source/deploys/6a17204e960bf70007833b01
😎 Deploy Preview https://deploy-preview-314--learn-open-source.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

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

PR Compliance Checks

Thank you for your Pull Request! We have run several checks on this pull request in order to make sure it's suitable for merging into this project. The results are listed in the following section.

Issue Reference

In order to be considered for merging, the pull request description must refer to a specific issue number.
This check is looking for a phrase similar to: "Fixes #XYZ" or "Resolves #XYZ" where XYZ is the issue number that this pull request is meant to address.

Add back the issue creation step as it's important for teaching new contributors about the issue -> PR workflow.

Changes:
- Add Step 1: Create an Issue with detailed instructions
- Include emphasis on noting issue number
- Add 'Closes #issue-number' instruction in PR step
- Explain why linking issues is important
- Renumber all subsequent steps (2-9)

This ensures contributors learn the complete workflow: issue creation -> code changes -> PR with proper linking.

Co-authored-by: Cursor <cursoragent@cursor.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.

1 participant