Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Update "Let's Get Practical" and "Merge Conflicts" sections #100

Merged
merged 32 commits into from
Dec 22, 2023

Conversation

adiati98
Copy link
Member

@adiati98 adiati98 commented Dec 19, 2023

Description

This PR mainly updates:

  • "Let's Get Practical" section
  • "Merge Conflicts" section

It also improves and reorganize some parts of the "How to Contribute to Open Source" chapter to adjust and clarify above sections, and for better flow.

What type of PR is this? (check all applicable)

  • πŸ• Feature
  • πŸ› Bug Fix
  • πŸ“ Documentation Update
  • 🎨 Style
  • πŸ§‘β€πŸ’» Code Refactor
  • πŸ”₯ Performance Improvements
  • βœ… Test
  • πŸ€– Build
  • πŸ” CI
  • πŸ“¦ Chore (Release)
  • ⏩ Revert

Related Tickets & Documents

Closes #99

Mobile & Desktop Screenshots/Recordings

Steps to QA

Added to documentation?

  • πŸ“œ README.md
  • πŸ““ docs.opensauced.pizza
  • πŸ• dev.to/opensauced
  • πŸ“• storybook
  • πŸ™… no documentation needed

[optional] Are there any post-deployment tasks we need to perform?

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

@adiati98 adiati98 added the documentation Improvements or additions to documentation label Dec 19, 2023
@adiati98 adiati98 self-assigned this Dec 19, 2023
Copy link

netlify bot commented Dec 19, 2023

βœ… Deploy Preview for sauced-intro ready!

Name Link
πŸ”¨ Latest commit 6ceedb8
πŸ” Latest deploy log https://app.netlify.com/sites/sauced-intro/deploys/658449e44d992a00085969cb
😎 Deploy Preview https://deploy-preview-100--sauced-intro.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 site configuration.

Copy link
Member Author

@adiati98 adiati98 left a comment

Choose a reason for hiding this comment

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

@BekahHW I'd like to hear your thoughts here. Thanks! 😊

05-how-to-contribute-to-open-source.md Outdated Show resolved Hide resolved
05-how-to-contribute-to-open-source.md Outdated Show resolved Hide resolved
05-how-to-contribute-to-open-source.md Outdated Show resolved Hide resolved
05-how-to-contribute-to-open-source.md Outdated Show resolved Hide resolved
05-how-to-contribute-to-open-source.md Outdated Show resolved Hide resolved
Copy link
Contributor

@CBID2 CBID2 left a comment

Choose a reason for hiding this comment

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

Hi @adiati98. Nice job! :) I gave some ideas on how to improve section a bit more.

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>
@BekahHW
Copy link
Member

BekahHW commented Dec 20, 2023

I'd like to make sure I take a look at this in its entirety before it's merged in. I've done a quick glance but I'll get to the rest tomorrow morning.

- Using the CLI tool.
- Manually editing the `.all-contributorsrc` file.

Although adding yourself to the guest book with the CLI tool is simpler, we recommend manually editing the file to get more experience adding and committing your changes, creating pull requests, and pull request reviews. Below, you'll find the directions for each method:
Copy link
Member

Choose a reason for hiding this comment

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

This is just a note to say that we should evaluate this part in the future. We may want to encourage the CLI tool and then say something like, Once you've contributed to the guestbook, you can get more practice with the Pizza-verse repo or something. I think it would reduce the number of incomplete PRs.

Copy link
Member Author

@adiati98 adiati98 Dec 22, 2023

Choose a reason for hiding this comment

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

We definitely can review it in the future. 😊

What I see often happen with incomplete PRs is that folks tend to miss the step to generate the README either they use CLI or add manually.

The concern with adding manually is that if they don't stick to the list of there's a typo, it will break the CLI.

@BekahHW BekahHW merged commit a5a10bf into open-sauced:main Dec 22, 2023
4 checks passed
@adiati98 adiati98 deleted the docs/update-lets-get-practical branch December 23, 2023 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
3 participants