fix: broken Auth0 Management Dashboard links#388
Conversation
5801056 to
0c7282a
Compare
0c7282a to
57fc5ef
Compare
| * If you encounter this scenario after managing your custom providers through multiple methods (Terraform, Auth0 Dashboard, <Tooltip tip="Management API: A product to allow customers to perform administrative tasks." cta="View Glossary" href="/docs/glossary?term=Management+API">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider. | ||
|
|
||
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](/docs/$manage_url#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file | ||
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default |
There was a problem hiding this comment.
🖐🏽 Change Request: https://manage.auth0.com/#/branding doesn't redirect you to the place this document is talking about. In the document there is references to this address: https://manage.auth0.com/dashboard/{locale}/{tenant_name}/templates/provider. If we update this to https://manage.auth0.com/#/templates/provider we'll redirect to the correct page.
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default | |
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/templates/provider) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default |
Out of Scope:
✍🏽 Content: There is no 'reset' button on this page anymore. This doc needs to be updated to talk about the toggle switch that exists on the page that you would turn off to reset back to default.
There was a problem hiding this comment.
Looking at this, then the "select Email Provider" statement becomes superfluous. Do you think rewriting this content should be in scope of this link focused change set? Happy to add while I'm in here, but I think there will be many such observations across the docs content.
There was a problem hiding this comment.
There is still a Reset button at the bottom of the page in Dashboard, so we can go with Bobby's suggestion here.
There was a problem hiding this comment.
@mikemimik - I'll make a ticket to update the step on this doc and the next one. For this PR tho, we can go with Bobby's suggestion to fix the link. Strange that the old variable translated this way.
| * If you encounter this scenario after managing your custom providers through multiple methods (Terraform, Auth0 Dashboard, <Tooltip tip="Management API: A product to allow customers to perform administrative tasks." cta="View Glossary" href="/docs/glossary?term=Management+API">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider. | ||
|
|
||
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](/docs/$manage_url#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file | ||
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default |
There was a problem hiding this comment.
🖐🏽 Change Request:
(☝🏽 Similar to previous comment - including out of scope)
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default | |
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/phone/templates/phone/provider) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default |
There was a problem hiding this comment.
Same comment here. If I make such a content change then "select Phone Provider." becomes superfluous.
| Un produit permettant aux clients d’effectuer des tâches administratives." cta="Voir le glossaire">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider. | ||
|
|
||
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://auth0.com/docs/$manage_url#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file | ||
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default |
There was a problem hiding this comment.
🖐🏽 Change Request:
- ☝🏽 Similar to previous comment
- This needs to be translated into French
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default | |
| To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/templates/provider) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default |
| Un produit permettant aux clients d’effectuer des tâches administratives." cta="Voir le glossaire">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider. | ||
|
|
||
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://auth0.com/docs/$manage_url#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file | ||
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default |
There was a problem hiding this comment.
🖐🏽 Change Request:
- ☝🏽 Similar to previous comment
- This needs to be translated into French
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default | |
| To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/phone/templates/phone/provider) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default |
There was a problem hiding this comment.
Should translations be in scope here? Again, much more content on this page will need to be translated.
|
Good feedback, thanks @mikemimik will address! Some of these I had to interpolate because content was both mangled and truncated. Other bits seem to be inconsistent based on existing examples (e.g. French link titles being in English seems common, but gen on the same page). I think generally the translation need a deep review for these types of things. |
|
Hey @btiernay, I agree with what you're saying, the scope of the change shouldn't include the translations, just pointing it out so we'll remember to have a look. The wider content team is doing an audit next year, so things like this will get worked out. I also don't think it's in scope to update any words, just making sure the links get to the correct location is good enough. If we're sure that all the links into the management dashboard are updated correctly, I'm happy to approve. |
The content team will do the suggested updates in another PR
Description
Fixes broken Auth0 Management Dashboard links.