PR Summary

This pull request introduces several enhancements to the Makefile used for managing the documentation site. The key changes include:

1. Branch-Specific Deployment and Cleanup:

   • Added a new variable GIT_BRANCH to capture the current git branch name.
   • Introduced two new targets: deploy-demo-branch and delete-demo-branch.
     • deploy-demo-branch: Deploys the documentation site for the current branch to a specific S3 path and invalidates the CloudFront cache.
     • delete-demo-branch: Deletes the documentation site for the current branch from the S3 path and invalidates the CloudFront cache.

2. Enhanced Help Section:

   • Updated the help section to include the new targets and improved formatting for better readability.

3. Refined Existing Targets:

   • Modified the deploy-demo target to remove the --delete flag from the aws s3 sync command, ensuring that files are not deleted during the sync process.

These changes aim to improve the deployment workflow by allowing branch-specific previews and cleanups, making it easier to manage documentation updates for different branches.

Test Suggestions

• Test the deploy-demo-branch target to ensure it correctly deploys the documentation site for the current branch to the specified S3 path.
• Test the delete-demo-branch target to ensure it correctly deletes the documentation site for the current branch from the specified S3 path.
• Verify that the deploy-demo target still functions correctly without the --delete flag.
• Run the help target to ensure the help message displays all available targets with the correct formatting.
• Test the clean, clone, notebooks, python-docs, get-source, docs-site, deploy-prod, and release-notes targets to ensure they are unaffected by the changes.

Tweaked the help wording a bit since the suggested change is invalid syntax and was lacking some wording symmetry to show the relationship between the options: