search

bitwarden / passwordless-docs

Bitwarden Passwordless.dev documentation.
https://bitwarden.com/
16 stars 29 forks source link

Confusing tutorials for Node.js #127

Open jamesli2021 opened 5 days ago

jamesli2021 commented 5 days ago

I took a day to read all the tutorials, and I still have no clue why the Node.js guide is in such a messy state especially for vanilla JavaScript/TypeScript which assume to know something we have not started?

abergs commented 5 days ago

@jamesli2021 Are you referring to this tutorial?

https://docs.passwordless.dev/guide/backend/nodejs.html

And this example code?

https://github.com/bitwarden/passwordless-nodejs/blob/main/examples/simple-example/src/index.ts

What specifically did you find confusing?

jamesli2021 commented 5 days ago

@abergs Great, thanks for the Node.js link, The confusion on this page arises when you observe how a beginner developer might read it, particularly sections like "this", PHP, etc.

I struggled to understand the whole concept of applying Passwordless in Astro and whether I would need both backend and frontend components.

In comparison to Astro docs, you can find the entire flow in their documentation, which includes recipes and reference styles.

https://docs.astro.build/en/install-and-setup/ https://docs.astro.build/en/guides/backend/

That allows me to build a web app in minutes, not days.