https://enigmaglass-docs.github.io/enigmaglass/

Branch	Live Site	Test Status	CICD Status
main	Production Site
development	Development Site

The central repository for this project is enigmaglass.

1. Clone repository to your local machine:

git clone [email protected]:enigmaglass-docs/enigmaglass.git

cd enigmaglass

git checkout development

2. Checkout feature branch and create draft pull request into development:

git checkout -b feature/{YOUR_FEATURE_NAME_HERE}

Now you can make you changes to this branch. When you want to save your changes you can commit and push them to the remote server (Github).

# see your status
git status

# add all changes
git add .

# commit your changes
git commit -m "this is a commit message"

# push your branch to the remote
git push -u origin feature/{YOUR_FEATURE_NAME_HERE}

# NOTE: after you push your local branch to the remote it will track the remote, so you can just run
# git push

Once your local branch has been pushed to the remote server on Github, you can create a draft pull request into the development branch to review your changes. You can comment here with links to resources or notes for yourself as you work.

3. Test your changes locally:

# you must have Ruby and Jekyll installed

`bundle install`

`bundle exec jekyll serve --livereload`

4. Once you're happy with your changes locally you can test your changes using the Pheonix deploy by setting your pull request status as Ready for Review.

Note: Draft pull requests into development that are marked as Ready for Review will automatically be built and deployed with Github Pages using the Pheonix Build and Deploy workflow. This workflow can also be run manually on any branch. When the pull request is closed the Delete Pheonix Deployment workflow will delete the short-lived repository that was created to host the Github Pages site.

5. Once the Pheonix deploy has completed, click View Deployment to see you site being served by Github Pages:

6. When you're ready to promote your changes to development and your pull request has been approved, you can complete the pull request and delete your branch:

7. Approve the deployment to the development environment:

8. Verify that your changes are correct and the site is functioning as it should in the development environment:

9. Create a pull request to promote your changes from development to main to update the production site:

10. Once all tests have passed and your pull request has been approved, complete the pull request:

11. Approve the production deployment to the github-pagesenvironment:

12. Verify that your changes were successfully deployed to the production github-pages environment:

That's it! You've successfully updated the site!