How to contribute

We've strived to make the contribution process super simple! There are, however, some strict requirements for your content formatting, so please see this README when writing the actual content.

Once your content conforms to the requirements above, the following is the process you should follow to contribute to this project.

Setup your working repo

1. Fork original repo on your GH account
2. Clone forked version and move into its directory
3. Run git remote add upstream https://github.com/oracle-devrel/devo.tutorials.git

Add/modify your content in a branch

1. Run git checkout main to make sure the new branch comes from master
2. Create the new branch and switch to it: git checkout -b <BRANCH_NAME>
3. Do your implementation, then stage and commit it
   • git add .
   • git commit -am "insert your comments here"

Submit a Pull Request (PR)

1. Before submit a PR, check if any commits have been made to the upstream main by running:
   • git fetch upstream
   • git checkout main
   • git merge upstream/main
2. If any new commits, rebase your branch
   • git checkout <BRANCH_NAME>
   • git rebase main
3. Commit and Push changes
   • git add .
   • git commit -m "insert here your comments"
   • git push origin <BRANCH_NAME>
4. Create a Pull Request for your branch on GitHub by visiting your forked repo page.

When you create the PR, make sure to check the "Allow edits by maintainers" option in the PR. This allows for easy, rapid modifications that our tech editors might provide.

5. After you submit the Pull Request, sit tight and look for any comments, edits, approvals or rejections!

Cleanup / Align to the source repo

1. Once your PR has been approved and merged, it's time to do some cleanup.
2. Run git pull upstream main
3. Remove merged branch
   1. Run git checkout main
   2. Run git branch -d <BRANCH_NAME>
4. Commit
5. Update the master branch in your forked repo
   1. Run git push origin main
6. Remove the branch from your forked repo
   1. Run git push --delete origin <BRANCH_NAME>

How to test your edits

We don't have a staging environment right now. However if you want to see how things will render while you're working on them you can take a look here

---

What our tech editors do

When a PR is received, our tech editors will usually refactor the content a bit, with the goal to make conveying your message as clearly as possible. Here's the process they go through to do this:

• git remote add pr<PR #> [email protected]/<your GH username>/devo.tutorials.git
• git fetch pr<PR #> <your BRANCH_NAME>
• git checkout -b pr<PR #> pr<PR #>/<your BRANCH_NAME>
• Changes/edits are made
• git add .
• git commit -m "Suggested edits for PR<PR #>"
• git push -f pr<PR #> HEAD

After the above is completed, the edited version will be included in the PR, at which point it can be merged (while still retaining the history and flow of the content).

Disclaimer

ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.