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

Docs: Replace code.code with code.authorizationCode #220

Conversation

menewman
Copy link
Contributor

Summary

Now, the documentation for model methods getAuthorizationCode and revokeAuthorizationCode consistently refer to code.authorizationCode rather than code.code.

Linked issue

Closes #216.

Involved parts of the project

Documentation only -- specifically for revokeAuthorizationCode and getAuthorizationCode.

Added tests?

N/A

OAuth2 standard

N/A

Reproduction

N/A

daniel.santos and others added 30 commits December 18, 2021 18:27
# Conflicts:
#	lib/grant-types/refresh-token-grant-type.js
#	package-lock.json
 Merge pull request node-oauth#109 from dsschiramm/development
Thanks to @dsschiramm
Bumps [sinon](https://github.com/sinonjs/sinon) from 15.1.0 to 15.2.0.
- [Release notes](https://github.com/sinonjs/sinon/releases)
- [Changelog](https://github.com/sinonjs/sinon/blob/main/docs/changelog.md)
- [Commits](sinonjs/sinon@v15.1.0...v15.2.0)

---
updated-dependencies:
- dependency-name: sinon
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>
…isify-any

Merge pull request node-oauth#190 from node-oauth/refactor-native-promises
Bumps [eslint](https://github.com/eslint/eslint) from 8.42.0 to 8.44.0.
- [Release notes](https://github.com/eslint/eslint/releases)
- [Changelog](https://github.com/eslint/eslint/blob/main/CHANGELOG.md)
- [Commits](eslint/eslint@v8.42.0...v8.44.0)

---
updated-dependencies:
- dependency-name: eslint
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>
…yarn/eslint-8.44.0

build(deps-dev): bump eslint from 8.42.0 to 8.44.0
Bumps [eslint](https://github.com/eslint/eslint) from 8.42.0 to 8.46.0.
- [Release notes](https://github.com/eslint/eslint/releases)
- [Changelog](https://github.com/eslint/eslint/blob/main/CHANGELOG.md)
- [Commits](eslint/eslint@v8.42.0...v8.46.0)

---
updated-dependencies:
- dependency-name: eslint
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>
jankapunkt and others added 10 commits August 2, 2023 16:27
…yarn/eslint-8.46.0

build(deps-dev): bump eslint from 8.42.0 to 8.46.0
…yarn/sinon-15.2.0

build(deps-dev): bump sinon from 15.1.0 to 15.2.0
Bumps [sinon](https://github.com/sinonjs/sinon) from 15.1.0 to 15.2.0.
- [Release notes](https://github.com/sinonjs/sinon/releases)
- [Changelog](https://github.com/sinonjs/sinon/blob/main/docs/changelog.md)
- [Commits](sinonjs/sinon@v15.1.0...v15.2.0)

---
updated-dependencies:
- dependency-name: sinon
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>
…yarn/sinon-15.2.0

build(deps-dev): bump sinon from 15.1.0 to 15.2.0
@menewman
Copy link
Contributor Author

@jankapunkt - I'm submitting what I believe is the correct documentation change, but I'm not quite sure how to generate/build the docs (haven't worked with Sphinx before and don't see an obvious "build docs" commands in the NPM package scripts). If you have any advice on building/testing that I should be doing for this, please lmk and I'd be happy to do so

@jankapunkt jankapunkt changed the base branch from development to master August 16, 2023 04:32
@jankapunkt
Copy link
Member

jankapunkt commented Aug 16, 2023

Hey @menewman thanks a lot for the PR, this is basically correct but with the exception, that we have a branching issue with git here 🙈

You did nothing wrong, since you were following the contribution guidelines! The issue we have is, that the docs are built on an external platform (readthedocs.io) and are by default pointing to the master branch. This is not covered in the contribution guidelines and I'm sorry for that, since this means extra work for you due to missing information (I will update the guidelines).

Background

Since we have not merged development into master yet, we have the uncomfortable situation of merging things that don't belong to your opened issue #216 and that should not be merged before the stable release 5.0.0 is out.

I even tried to resolve this but this just gets out of hand with such a big branch difference.

Solution

So I looked at your fork and here is how we can fix this the easiest way:

  • close this issue
  • checkout the master branch (git checkout master) on your fork
  • git pull
  • being on master branch, checkout a new branch git checkout -b docs-fix-code-parameters
  • do your changes and commit
  • push to git push origin docs-fix-code-parameters
  • open a new pull request but target the master branch, instead of development
  • now, there should only be changes in the docs folder detected by the diff algorithm

@menewman
Copy link
Contributor Author

No worries at all -- and thank you for the detailed steps! I'm happy to re-submit the PR with a different branch target 👍

@menewman menewman closed this Aug 16, 2023
@menewman menewman deleted the fix-replace-code-with-authorization-code-in-docs branch August 16, 2023 08:48
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.

[Documentation] revokeAuthorizationCode argument should be named code.authorizationCode, not code.code
3 participants