okta-developer-docs icon indicating copy to clipboard operation
okta-developer-docs copied to clipboard

Update telephony hook docs to use Twilio Verify

Open robinske opened this issue 1 year ago • 4 comments

Hey folks - Everything is now self service so re-opening this change request.

I work on technical content focusing on authentication over at Twilio. We just published a blog post for how to BYOT with our Verify API. The changes here reflect our updated guidance to use the Verify API over messaging/voice separately for simpler and faster integration (using Verify avoids 10DLC and other regulatory registration).

I also updated the Glitch project which you can see here: https://glitch.com/edit/#!/dune-resilient-aragosaurus

robinske avatar Jul 30 '24 19:07 robinske

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.

Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article Total score
Required:80
Word and phrases
(Brand, terms)
Preferred: 80
Correctness
(Spelling, grammar)
Preferred: 80
Clarity
(Readability)
Preferred: 80
Inclusive language
(+ accesibility)
Preferred: 80
:white_check_mark: packages/@okta/vuepress-site/docs/guides/telephony-inline-hook/main/index.md 85 89 71 94 100
:white_check_mark: packages/@okta/vuepress-site/docs/guides/telephony-inline-hook/main/nodejs/sendotp.md 100 100 100 100 100

acrolinxdevdocs-okta avatar Jul 30 '24 19:07 acrolinxdevdocs-okta

@robinske - could you please email me at [email protected] so that we can discuss why we aren't updating this doc to use the service right now? Thanks.

susanharper-okta avatar Jul 31 '24 17:07 susanharper-okta

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.

Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article Total score
Required:80
Word and phrases
(Brand, terms)
Preferred: 80
Correctness
(Spelling, grammar)
Preferred: 80
Clarity
(Readability)
Preferred: 80
Inclusive language
(+ accesibility)
Preferred: 80
:white_check_mark: packages/@okta/vuepress-site/docs/guides/telephony-inline-hook/main/index.md 85 89 71 94 100
:white_check_mark: packages/@okta/vuepress-site/docs/guides/telephony-inline-hook/main/nodejs/sendotp.md 100 100 100 100 100

acrolinxdevdocs-okta avatar Aug 01 '24 00:08 acrolinxdevdocs-okta

I need to test this and verify the doc pretty quickly. Hopefully right after API migration madness is over.

susanharper-okta avatar Aug 01 '24 00:08 susanharper-okta