You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I recently received a comment from a user, in which the user stated that they were having difficulty understanding "how releases relate to commits, packages/services, projects, deploys, source maps." I fully agree with the user's comment. I have also struggled to understand how releases, projects, deploys, sourcemaps, packages, services, etc. all relate too each other while investigating this issue and other Sentry CLI issues which deal with these concepts, and it has been difficult to find any answers in the docs. This has slowed down my investigations of such issues, since I have had to read through source code anytime I needed to understand how these concepts are actually related to each other. Clarifying these docs would likely not only benefit customers, but also developers at Sentry to understand how these concepts are supposed to relate to each other.
Suggested Solution
We should take some time to fully understand the relationships between releases, commits, projects, deploys, source maps, etc., and we should clearly document these, perhaps with some sort of diagram.
The text was updated successfully, but these errors were encountered:
Looks like our Python docs already are describing what Releases are, perhaps this could be moved somewhere else to make it clear that this description generally applies to all platforms, not just Python projects.
I cannot find any docs page that explains what a Deploy is, at a high level
Clarifying Releases and Deploys should be enough to close this issue (this was the main confusion prompting this issue to be opened). Perhaps, we explain how both of these relate to the other concepts listed in the original description (e.g. a project can have multiple releases, a release is associated with one project)
Core or SDK?
Platform/SDK
Which part? Which one?
Sentry CLI
Description
I recently received a comment from a user, in which the user stated that they were having difficulty understanding "how releases relate to commits, packages/services, projects, deploys, source maps." I fully agree with the user's comment. I have also struggled to understand how releases, projects, deploys, sourcemaps, packages, services, etc. all relate too each other while investigating this issue and other Sentry CLI issues which deal with these concepts, and it has been difficult to find any answers in the docs. This has slowed down my investigations of such issues, since I have had to read through source code anytime I needed to understand how these concepts are actually related to each other. Clarifying these docs would likely not only benefit customers, but also developers at Sentry to understand how these concepts are supposed to relate to each other.
Suggested Solution
We should take some time to fully understand the relationships between releases, commits, projects, deploys, source maps, etc., and we should clearly document these, perhaps with some sort of diagram.
The text was updated successfully, but these errors were encountered: