tip_of_the_hat

Hey HN, author here.

I got some positive feedback on my previous article; Learn OAuth 2.0 by building an OAuth client (https://annotate.dev/p/hello-world/learn-oauth-2-0-by-buildi...) and created a follow up on the OIDC standard.

Let me know what you think and if you have any feedback!

Yup, planning on expanding to add a PKCE and OIDC walkthroughs as well!

Agreed, I think it's something you should know how to do and then choose not to do it (use an existing library instead). Having a good understanding really helps with debugging issues that come up.

This was my experience as well. I've previously blindly followed instructions from OAuth libraries, but it frustrated me that I didn't fully understand what was going on.

Pretty much all of it! The JS in this walkthrough is all server-side. I tried to keep the JS itself simple so that someone unfamiliar with the language could have an easy time following the code.

Hey HN, author here.

When I was first learning OAuth, I found that all the guides were text-heavy and lacked code. I personally learn better from code, so I created a code-first guide. Let me know if you have any feedback!

Just to clarify, this use case would be for internal code documentation rather than providing external walkthroughs for your users?

Not yet, what use case do you have in mind for self hosting?

Thanks for checking it out!

I'd be happy to build and support an on-prem solution, but I'd a need commitment from an enterprise/government org. If that's something you're interested in, shoot me an email at alex@annotate.dev!

Thank you for checking it out!

I use Figma to get a proof of concept of how I want things laid out. From there it's more tinkering at the code level.

Thanks for taking a look and sharing feedback!

I'm not familiar with the c4 model, I'll need to investigate.

> Why not make clickable code references visually stand out

Is the goal here that you want to know that a specific text block annotates a part of the code?

> Make a VScode extension for it

I think I will! I need to noodle a bit on the user experience here

It's the first time I've heard of CodeTour, I'm really impressed from what I've seen thus far. Digging a bit deeper now, thanks for sharing!

This is great feedback, not something I initially considered. I've add it to my todo list

Thanks for the kind words!

Not currently, can you elaborate why you'd want to the code window at the bottom?

I'm working https://annotate.dev, a tool inspired by the Stripe documentation, to let anyone create step by step code walkthroughs. Here's a sample of a walkthrough you can create: https://annotate.dev/p/hello-world/learn-oauth-2-0-by-buildi...

Would love to hear any feedback thoughts!