Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

oktanaut blog #1470

Merged
merged 27 commits into from
Dec 20, 2023
Merged

oktanaut blog #1470

merged 27 commits into from
Dec 20, 2023

Conversation

isemona
Copy link
Contributor

@isemona isemona commented Dec 6, 2023

This blog post has the following features:

  • A GitHub Repository with a polished README
  • A GitHub Repository under the github.com/oktadev account
  • A title that's approved by Dev Advocacy
  • A URL approved by Dev Advocacy
  • The content has been run through Grammarly (https://www.grammarly.com/)
  • Rendered locally and confirmed that no Markdown typos exist
  • Images are compressed appropriately
  • Social image previews well on Twitter and LinkedIn
  • Tech review request (developer advocate or domain expert)
  • Review request for editorial/grammar/clarity (developer advocate or Colton)

@isemona isemona requested a review from edunham December 6, 2023 00:33
Copy link

netlify bot commented Dec 6, 2023

Deploy Preview for okta-blog ready!

Name Link
🔨 Latest commit 19ad6c0
🔍 Latest deploy log https://app.netlify.com/sites/okta-blog/deploys/6583327cad32ea0008e8a04e
😎 Deploy Preview https://deploy-preview-1470--okta-blog.netlify.app/blog/2023/12/20/okta-documentation-chatbot
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@isemona isemona requested a review from alisaduncan December 7, 2023 19:18
Copy link
Member

@alisaduncan alisaduncan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stopping for now

_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
{% img blog/okta-documentation-chatbot/api.jpeg alt:"api-image" height:"400" %}{: .center-image }
– Image source: <cite>[OpenAI APIs with Python — Complete Guide](https://medium.com/@marc.bolle/openai-apis-with-python-complete-guide-d933fb770f95)</cite>

The second version took a different approach. Using LLamaIndex, I crafted a custom chatbot exclusively trained on the Okta developer documentation. While this version's responses were more accurate due to its focused training, it needed to be more comprehensive in handling a diverse range of questions compared to the GPT-3.5-powered counterpart.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please make sure to link LlamaIndex, and is the capitalization of Okta developer documentation correct for our brand? (idk)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so you are suggesting changing Okta developer documentation to Okta Developer Documentation?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the suggestion is to check the style guides linked from https://docs.google.com/document/d/1GjvQQoJJLy4bJIS9Yk5vyzy9tnxDcKcMJ1-yqc-Z-f8/edit. https://github.com/okta/okta-developer-docs/wiki/Style-Guide demonstrates that we do capitalize Dev Docs.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(why yes i did just search our google drive for "style guide" and grab the first promising-looking link there lol)

@edunham
Copy link
Member

edunham commented Dec 8, 2023

Would you be ok with "how I built" instead of "how to build"? "how to" suggests a more comprehensive guide whereas this is a nice focused writeup on one of the many possible ways to solve the problem.

Copy link
Member

@edunham edunham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lots of little touchups, fine to accept/reject as your editorial preferences guide you @isemona :)

_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
_source/_posts/2023-10-12-okta-documentation-chatbot.md Outdated Show resolved Hide resolved
@isemona isemona merged commit 45b924b into oktadev:main Dec 20, 2023
6 checks passed
@isemona isemona deleted the tanish-blog branch December 20, 2023 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants