redwood icon indicating copy to clipboard operation
redwood copied to clipboard

Added warning note to not add WebAuthn

Open pantheredeye opened this issue 11 months ago • 4 comments

I added a warning note below yarn rw g dbAuth alerting the user to not add WebAuthn. Adding it breaks the login pages and the tutorial does not address how to correct it. Not adding webauthn is the easy answer.

@cannikin What do you think about this language? I wanted to add something like 'feel free to add later' but that just got long. I wanted the warning instead of tip or info because it does break the app if added.

Background: We had a user following the tutorial, added dbAuth with WebAuthn, and it broke her app. She tried debugging and couldn't make headway and finally came to the discord for help. Basically, I deleted the dbauth generated pages, installed it without webauthn and everything worked.

pantheredeye avatar Mar 15 '24 22:03 pantheredeye

Ahhh great call, I forgot about the fact that we added WebAuthn support after the tutorial, but never went back and updated it. Thanks! You might want to backport this language into previous doc releases as well. Not sure what Redwood release we added WebAuthn, but probably at least v4? Take a look in the versioned_docs directory were all the previous releases are stored.

cannikin avatar Mar 15 '24 22:03 cannikin

Looks like v3 from the release notes.

Do I need to add to v7.0 as well? I'm not sure if what I added to is 7.0 or 7.1 or both.

pantheredeye avatar Mar 15 '24 22:03 pantheredeye

If there's a 7.0 in versioned docs I think you'd need to add it to that, yeah. When you add to just the root it gets assigned to the latest point release, so that's 7.1. You'd need to manually add to 7.0 and below in versioned_docs

cannikin avatar Mar 15 '24 22:03 cannikin

@pantheredeye Once the language is finalized, could you move the file changes from the other PRs into this PR, so there's just one PR associated with this change across all doc versions? Lastly, I don't think it's necessary to go back through all doc versions. >= v6 seems reasonable to me. Your call.

Thanks for working on this!

thedavidprice avatar Mar 19 '24 15:03 thedavidprice

I updated this PR with a commit that

  1. makes the requested punctuation change
  2. updates current, v7.0 and v6.x doc sets

We should be good to go. Please let me know if something isn't working right!

pantheredeye avatar May 11 '24 15:05 pantheredeye

Thanks @pantheredeye LGTM but I'll assume @Tobbe is managing final review and merge (just let me know otherwise).

I've closed out:

  • https://github.com/redwoodjs/redwood/pull/10235
  • https://github.com/redwoodjs/redwood/pull/10234
  • https://github.com/redwoodjs/redwood/pull/10233
  • https://github.com/redwoodjs/redwood/pull/10232
  • https://github.com/redwoodjs/redwood/pull/10236

thedavidprice avatar May 11 '24 18:05 thedavidprice