# Docs - Blue Canvas DevOps for Salesforce Documentation

> Salesforce DevOps documentation to enable version control, metadata backups and continuous integration with Blue Canvas.

## Guides
- [Getting Started with Salesforce DevOps using Blue Canvas](https://docs.bluecanvas.io/docs/getting-started.md): This page will help you get started with Blue Canvas. You'll be up and running in a 4 clicks!
- [Salesforce Version Control in Blue Canvas](https://docs.bluecanvas.io/docs/visualize-with-the-blue-canvas-ui.md): How to use the Blue Canvas UI to see everything that is happening on your Salesforce Orgs over time
- [Quick Sync | Blue Canvas](https://docs.bluecanvas.io/docs/quick-sync.md): Benefit from faster sync between your Salesforce sandboxes and Blue Canvas
- [Deploying Metadata between Salesforce orgs](https://docs.bluecanvas.io/docs/deploying-between-orgs.md): Use Blue Canvas to compare two orgs, cherry-pick changes from a source org, and deploy them to a target org.
- [Deployment Checklists](https://docs.bluecanvas.io/docs/manual-and-pre-and-post-deployment-checklists.md): Create a list of items with checkboxes to track Pre- and Post-Deployment Steps between Salesforce orgs.
- [Line-by-line editing in deployments](https://docs.bluecanvas.io/docs/line-by-line-editing-in-deployments.md): How to cherrypick specific lines of a file in a Salesforce deployment with Blue Canvas.
- [Deploying Salesforce Profiles & Permission Sets](https://docs.bluecanvas.io/docs/deploying-salesforce-profiles-permission-sets.md): Learn how to deploy Profiles & Permission Sets between orgs, and bundle it with your Metadata release.
- [Rollback deployments in Salesforce](https://docs.bluecanvas.io/docs/rollback-a-salesforce-release.md): How to rollback a Salesforce release with Blue Canvas and Git.
- [Merging between Salesforce orgs](https://docs.bluecanvas.io/docs/merging.md): Learn how Blue Canvas detects on-the-fly if your deployment is conflicting with other changes that happened on the destination org
- [Merging with Conflicts](https://docs.bluecanvas.io/docs/merging-with-conflicts.md): Learn how Blue Canvas helps solve merge conflict between Salesforce orgs.
- [Using the Merge Editor](https://docs.bluecanvas.io/docs/merge-editor.md): Blue Canvas' Merge Editor lets you diagnose and solve conflicts between Salesforce orgs.
- [Bulk Releases](https://docs.bluecanvas.io/docs/releasing-multiple-features-at-once.md): How to release multiple "stories" to other environments in a single deployment.
- [Jira Integration](https://docs.bluecanvas.io/docs/integrating-blue-canvas-with-jira.md): How to connect your Jira issues to Salesforce deployments using Blue Canvas.
- [External Source Control for Salesforce](https://docs.bluecanvas.io/docs/integrating-blue-canvas-with-github-bitbucket-and-gitlab.md): Learn how to integrate Blue Canvas with VSTS, GitHub, Bitbucket and GitLab.
- [GitHub and Salesforce](https://docs.bluecanvas.io/docs/github-salesforce.md): How to track Salesforce Metadata in GitHub with Blue Canvas.
- [Bitbucket | ESC for Salesforce](https://docs.bluecanvas.io/docs/bitbucket.md): How to track Salesforce Metadata in Bitbucket with Blue Canvas.
- [GitLab | ESC for Salesforce](https://docs.bluecanvas.io/docs/gitlab.md): How to track Salesforce Metadata in GitLab with Blue Canvas.
- [Azure DevOps (VSTS)](https://docs.bluecanvas.io/docs/visual-studio-team-services-salesforce.md): Learn how to connect Blue Canvas with Azure DevOps (VSTS  - Visual Studio Team Services)
- [Git-based development with Blue Canvas](https://docs.bluecanvas.io/docs/git-flow-with-blue-canvas.md): Understand how Blue Canvas enables a Git flow for Salesforce development and continuous deployments.
- [Invite Users](https://docs.bluecanvas.io/docs/user-management-deployment-permissions.md): How to invite users and set up permissions for your team.
- [Roles and Permissions](https://docs.bluecanvas.io/docs/roles-and-permissions.md)
- [Export History](https://docs.bluecanvas.io/docs/exporting-git-history-from-blue-canvas.md): There are two ways to export your Git history from Blue Canvas. Here's how to use both.
- [Real-Time Sync](https://docs.bluecanvas.io/docs/real-time-sync.md): Deploy live metadata from your Salesforce org, without having to wait for a sync.
- [Configuring Metadata](https://docs.bluecanvas.io/docs/configuring-metadata.md)
- [Supported Metadata List](https://docs.bluecanvas.io/docs/supported-metadata.md)
- [Picklist value considerations](https://docs.bluecanvas.io/docs/picklist-value-considerations.md)
- [Legacy branch syncs](https://docs.bluecanvas.io/docs/legacy-branch-syncs.md): A guide to migrate to NextGen syncs with a single click. This page also links to the documentation for legacy branch syncs.
- [Supported Metadata](https://docs.bluecanvas.io/docs/what-does-blue-canvas-track.md): Blue Canvas tracks your Salesforce Metadata with Git. As any Salesforce developer knows, not all Metadata was created equal. Here is some information on which kinds of metadata are tracked today and which will be tracked later.
- [Deploying Communities with Blue Canvas](https://docs.bluecanvas.io/docs/communities.md): Blue Canvas supports deploying communities with some additional setup. Both Lightning Communities and Classic Communities can be tracked and deployed.
- [Controlling deployability of requests](https://docs.bluecanvas.io/docs/controlling-deployability-of-requests.md): You can require deployment requests to pass a set of checks before they can be deployed. For example, you can block deployment requests that don't pass external status checks or require that deployment requests have a specific number of approving reviews before they can be deployed.
- [About protected branches](https://docs.bluecanvas.io/docs/about-protected-branches.md): Protected branches ensure that certain conditions are met before deploying changes to branches, like required status checks and required reviews.
- [Configuring protected branches](https://docs.bluecanvas.io/docs/configuring-protected-branches.md): If you're a repository owner, you can customize branch protections in the repository and enforce certain workflows, such as requiring more than one peer review or requiring certain status checks to pass before allowing a deployment request to be deployed.
- [Single Sign-On](https://docs.bluecanvas.io/docs/single-sign-on.md)
- [Deleting a branch or connection](https://docs.bluecanvas.io/docs/deleting-a-branch-or-connection.md)
- [Receive notifications on messengers](https://docs.bluecanvas.io/docs/receive-notifications-on-messengers.md): You can connect external messaging platforms to Blue Canvas to receive notifications when deployment requests are created, changed, validated, and more.
- [Notifications on Slack](https://docs.bluecanvas.io/docs/slack-notifications.md)
- [Notifications on Microsoft Teams](https://docs.bluecanvas.io/docs/notifications-on-microsoft-teams.md)
- [Notifications on Webex](https://docs.bluecanvas.io/docs/webex-notifications.md)
- [Next-Gen Sync Features](https://docs.bluecanvas.io/docs/next-gen-sync-features.md)
- [Sync Schedule](https://docs.bluecanvas.io/docs/sync-schedule.md)
- [Metadata Synchronization Rules](https://docs.bluecanvas.io/docs/metadata-synchronization-rules.md)
- [Sync Logs](https://docs.bluecanvas.io/docs/sync-logs.md)
- [Realtime Sync Control](https://docs.bluecanvas.io/docs/realtime-sync-control.md)
- [Reconnecting After a Sandbox Refresh](https://docs.bluecanvas.io/docs/sandbox-refresh.md): How to reestablish a connection to Blue Canvas after a sandbox refresh.
- [Troubleshooting](https://docs.bluecanvas.io/docs/troubleshooting.md)
- [FAQ | Blue Canvas](https://docs.bluecanvas.io/docs/faq.md)
- [Fixing Authorization Errors](https://docs.bluecanvas.io/docs/fixing-authorization-errors.md)

## API Reference
- [Getting Started](https://docs.bluecanvas.io/reference/introduction.md)
- [Get a deployment by number](https://docs.bluecanvas.io/reference/get-a-deployment-by-number.md)
- [Using the Checks API](https://docs.bluecanvas.io/reference/using-the-checks-api.md)
- [Upsert a Check](https://docs.bluecanvas.io/reference/put-checks.md): Creates or updates the status of a check for a given deployment by its canonical check name. The first time you invoke this action, a new record for the check is created and will appear in the interface. Successive calls to this action update the state of that record. This allows you to update the status of a check as it progresses in your external system.
- [Delete a Check](https://docs.bluecanvas.io/reference/delete-a-check.md): We recommend updating existing checks to a SUCCESS or a SKIPPED state, this will unblock the user from deploying. However for completeness we allow you to remove the checks in case they where created by mistake.
- [Get an Archive of Files](https://docs.bluecanvas.io/reference/get-archives.md): Retrieves a gzipped tarball (.tar.gz) of the file tree for the specified revision. Use this to fetch a copy of all files for local code inspection.
- [Using the Webhooks API](https://docs.bluecanvas.io/reference/using-the-webhooks-api.md)
- [branches/committed](https://docs.bluecanvas.io/reference/branches-committed.md): Emitted once when a new deployment request is created. This document describes an event that occurs when a new commit is pushed to a branch.
- [deployments/created](https://docs.bluecanvas.io/reference/deploymentscreated.md): Emitted once when a new deployment request is created. This document explains that the event discussed only occurs when a Deployment Request is created, and suggests looking at the, `deployments/validating` event for triggering on code modification.
- [deployments/reviewed](https://docs.bluecanvas.io/reference/deployments-reviewed.md): Emitted when a user reviews a deployment request.
- [deployments/validating](https://docs.bluecanvas.io/reference/deploymentsvalidating.md): Emitted when Blue Canvas is starting to validate against Salesforce.
- [deployments/validated](https://docs.bluecanvas.io/reference/deploymentsvalidated.md): Emitted when validation against Salesforce is complete.
- [deployments/deployed](https://docs.bluecanvas.io/reference/deployments-deployed.md): Emitted when the deployment against Salesforce is complete.

## Changelog
- [Improving the Compare Page](https://docs.bluecanvas.io/changelog/improving-the-compare-page.md)
- [Add Profiles & Permissions directly in your Blue Canvas deployment](https://docs.bluecanvas.io/changelog/add-profiles-permissions-directly-in-your-blue-canvas-deployment.md)
- [Block edits of approved deployments, and avoid last-minute surprises](https://docs.bluecanvas.io/changelog/block-edits-of-approved-deployments-and-avoid-last-minute-surprises.md)
- [Merge Conflict Resolution is live!](https://docs.bluecanvas.io/changelog/merge-conflict-resolution-is-live.md)
- [Salesforce & Git Quick Sync](https://docs.bluecanvas.io/changelog/quick-sync.md)
- [Auto-suggest tests, Test suites](https://docs.bluecanvas.io/changelog/cr-20220523-1.md)
- [Custom Coverage; Email and Teams Notifications](https://docs.bluecanvas.io/changelog/cr-20220430-1.md)
- [Enforce Code Coverage, Mobile CSS](https://docs.bluecanvas.io/changelog/cr-20220425-1.md)
- [Automatic Dependency Detection](https://docs.bluecanvas.io/changelog/cr-20220419-2.md)
- [Native Slack Notifications](https://docs.bluecanvas.io/changelog/cr-20220316-1.md)