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
Currently, the root page for the SDKs is a quick start guide.
For example, the default page for JavaScript is the JavaScript quick start guide https://docs.sentry.io/platforms/javascript/.
(I call this the SDK landing page in this issue)
Depending on how a user navigates to this page, they may have overlooked the framework-specific SDKs.
The blue info box (see screenshot) is a good quick fix that probably already helped many users find the guides they need.
Still, the way the user gets to this section of the Docs could be further improved.
I created this issue to gather ideas for improving the SDK landing pages and providing a more elegant solution.
So please share any of your ideas and current pain points regarding the SDK landing pages
Solution Brainstorm
Here are my thoughts and ideas:
Restructuring the framework tree
Reduce "JavaScript" to a single page that acts as a more general entry point (and not a quick start guide) and move the current "JavaScript" section under this landing page so it is on the same level as other frameworks.
(To not confuse users, we'd need to rename the pages :) )
Repurposing the landing page
On this landing page, we could provide the list of (JS) frameworks (similar to here: https://docs.sentry.io/platforms/).
Additionally, we could offer more information and resources to help users start/continue working with the SDKs.
React Native and Unity, for example, only have one SDK -> should they stay as they are now, or should we also adapth them to be consistent with the other SDKs
if we provide links to other resources (like videos, blog posts, etc) then we need to maintain these and make sure to add/replace content
The text was updated successfully, but these errors were encountered:
Problem Statement
Currently, the root page for the SDKs is a quick start guide.
For example, the default page for JavaScript is the JavaScript quick start guide https://docs.sentry.io/platforms/javascript/.
(I call this the SDK landing page in this issue)
Depending on how a user navigates to this page, they may have overlooked the framework-specific SDKs.
The blue info box (see screenshot) is a good quick fix that probably already helped many users find the guides they need.
Still, the way the user gets to this section of the Docs could be further improved.
I created this issue to gather ideas for improving the SDK landing pages and providing a more elegant solution.
So please share any of your ideas and current pain points regarding the SDK landing pages
Solution Brainstorm
Here are my thoughts and ideas:
Restructuring the framework tree
Reduce "JavaScript" to a single page that acts as a more general entry point (and not a quick start guide) and move the current "JavaScript" section under this landing page so it is on the same level as other frameworks.
(To not confuse users, we'd need to rename the pages :) )
Repurposing the landing page
On this landing page, we could provide the list of (JS) frameworks (similar to here: https://docs.sentry.io/platforms/).
Additionally, we could offer more information and resources to help users start/continue working with the SDKs.
Some examples:
Considerations
The text was updated successfully, but these errors were encountered: