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

Missing payload.auth from documentation #9631

Closed
HarleySalas opened this issue Nov 30, 2024 · 4 comments · Fixed by #9632
Closed

Missing payload.auth from documentation #9631

HarleySalas opened this issue Nov 30, 2024 · 4 comments · Fixed by #9632
Labels
created-by: Contributor documentation Improvements or additions to documentation

Comments

@HarleySalas
Copy link
Contributor

Documentation Issue

Local API does not document the payload.auth method.
https://payloadcms.com/docs/local-api/overview

This was brought to my attention when helping someone with custom components. They were able to figure out how to get the current user with the useAuth hook in the client, but were unaware of how to get the current user on the server. Apparently they had been trying to figure it out all day, with no luck. Thus, while it is not necessary to document everything right now, I do think this is a common scenario where people will need this piece of information now.

@HarleySalas HarleySalas added the documentation Improvements or additions to documentation label Nov 30, 2024
@yonnic
Copy link

yonnic commented Dec 1, 2024

what you can do in such case is to check the sample projects. There is a lot of code which is not documented.
I also use https://grep.app/ to find code parts for payload across all github

@HarleySalas
Copy link
Contributor Author

what you can do in such case is to check the sample projects. There is a lot of code which is not documented.
I also use https://grep.app/ to find code parts for payload across all github

I've been aware of the method for quite a long time. Its just clear to me that people aren't finding it and documenting it would help with that.

Many features aren't documented, I agree. I consider this to be a very core necessity, hence the PR.

Copy link
Contributor

github-actions bot commented Dec 3, 2024

🚀 This is included in version v3.3.0

Copy link
Contributor

github-actions bot commented Dec 5, 2024

This issue has been automatically locked.
Please open a new issue if this issue persists with any additional detail.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Dec 5, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
created-by: Contributor documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants