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

Improve documentation #157

Merged
merged 3 commits into from
Oct 6, 2023
Merged

Conversation

robinbrandt
Copy link
Contributor

@robinbrandt robinbrandt commented Aug 12, 2023

Hi!

Thanks for continuing to maintain the library. A couple of suggestions to improve the examples in the README.

  • clean up use of w for both the ResponseWriter and the webauthn.WebAuthn instance. The official go docs use w for the ResponseWriter so I suggest to optimize for familiarity and give the WebAuthn instance a new name
  • leverage the convenience functions FinishLogin and FinishRegistration (unless I'm missing something why the shouldn't be used)

@robinbrandt robinbrandt requested a review from a team as a code owner August 12, 2023 20:58
This changes the variable names of the examples slightly to use the commonly
used w for the ResponseWriter and removes the clash with the WebAuthn instance.

Signed-off-by: Robin Brandt <[email protected]>
The examples can be simplified to use the convenience functions offered by the
library.

Signed-off-by: Robin Brandt <[email protected]>
@james-d-elliott
Copy link
Member

Hey thanks for submitting this, I had meaned to look at it last week and provide feedback but ended up forgetting! Whoops! I'm sorry about this. I'll get to it today hopefully.

@dropwhile
Copy link

dropwhile commented Oct 6, 2023

As someone looking at this library for the first time, I found the changes @robinbrandt proposed here very useful for clearing up some of my confusion about the readme examples. 👍

@james-d-elliott james-d-elliott merged commit feda47a into go-webauthn:master Oct 6, 2023
4 checks passed
@robinbrandt robinbrandt deleted the improve-docs branch October 6, 2023 20:04
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