How to contribute - OpenLiberty/openliberty.io GitHub Wiki

When working on a new issue, this is the process that we follow in order to get the changes onto https://openliberty.io/.

1. Make sure you have your environment setup. If you haven't already, please follow the instructions here: https://github.com/OpenLiberty/openliberty.io/wiki/Setting-up-local-website-development
2. Check out the draft branch from https://github.com/OpenLiberty/openliberty.io/tree/draft
3. Run the command git checkout -b <branch_name> draft to create a branch off of draft. The branch name should be a useful name based on what you are fixing/implementing.
4. Make the required changes to address the issue you are working on.
5. When you have tested the changes locally and are ready to deliver, add the files to your git staging environment using git add <path_to_file>.
6. When all of the files you changed are added, run git commit -m "<insert_your_commit_message_here>" using a useful commit message for what you changed.
7. Push your changes to the https://github.com/OpenLiberty/openliberty.io repo. If you need more help on how to push to a remote see https://help.github.com/en/articles/pushing-commits-to-a-remote-repository.
8. Make a pull request from your branch into draft.
9. Assign a reviewer to code review your code. If you are unsure who should review your code, leave the reviewer field blank and someone from the website team will review your pull request when they see it.
10. If the reviewer requests changes, please make them on your local branch and test the changes. When ready, add the changes, commit them, and push the changes to the remote.
11. When the code reviewer approves your changes, they will merge your code into draft and after an hour test your changes visually on https://draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/ to make sure they are visually correct.
12. If they look correct, create a new branch off prod. For that, first check out the prod branch from https://github.com/OpenLiberty/openliberty.io/tree/prod. Then run the command git checkout -b <branch_name> to create a new branch off of prod.
13. Cherry pick all commits made in the previous pull request by running the command git cherry-pick <commit-hash>.
14. After all commits are cherry-picked and pushed, create a pull request from your new branch into staging and request a review again. Your changes will be built on https://staging-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/. Do a final check on the staging site once it is merged in and then create a pull request from staging into prod.