Closed rileyhgrant closed 1 year ago
Hi @josephinelee1234, I just added you as an assignee on this issue. This is both a worthwhile piece of documentation, and an opportunity to get you more comfortable with how GitHub is used for projects with collaborators, if you haven't used the Feature Branch workflow before. If you have, then it's good review!
I've outline the steps to go through the Feature Branch workflow (create your own branch off main
, perform any edits in your feature branch, then open a Pull Request (PR) to have your changes incorporated in main
). This workflow helps ensure that clean commits are the only things that make it into the main
branch.
Further, in this case, I believe there is some CD set up that will trigger an auto deploy upon any commit to main
. Thus, it is advantageous to be able to choose when to rebase commits into main
so that we can decide when we want to deploy code to production.
Create a
README.md
file. This helps new developers or curious users understand some basic facts about the repository.Using Git, create a feature branch, add the new file and make any changes in this branch, then open a Pull Request that includes the addition of that
README.md
file. (Any time you push any changes on a local feature branch to the repository withgit push
, the GitHub repository here should recognize that and display a banner prompting you to open a pull request right then and there)Some good things to include in the
README.md
would be:CONTRIBUTING.md
should they want to contributeHere are a few repos with READMEs for reference, if needed
In a bit more detail:
main
branch, create a feature branch to store your changes. Something likegit checkout -b jl/create-readme
will create a branch calledjl/create-readme
git branch -v
to ensure you're on your feature branch, and notmain
. The branch you've currently checked out will have an*
to the left of it.README.md
file in the root of the directory. Add any and all content you desire.git add README.md
)git push --set-upstream origin jl/create-readme
and is just what you want)