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

Consistent "get" or "fetch" in endpoint descriptions #7799

Open
david-crespo opened this issue Mar 14, 2025 · 1 comment
Open

Consistent "get" or "fetch" in endpoint descriptions #7799

david-crespo opened this issue Mar 14, 2025 · 1 comment

Comments

@david-crespo
Copy link
Contributor

david-crespo commented Mar 14, 2025

We use "fetch" in some spots, "get" in others. I thought we used fetch more, but that may not be true. Fetch feels more precise and technical, but it also is two characters longer for little benefit. I'll have to see how they each feel in context in the docs site to decide.

Thanks for the suggestions, I'll reword these. I notice that "get" and "fetch" are used pretty interchangeably in other APIs...we should probably give that a pass to make it more consistent (separately from this PR of course):
image

Originally posted by @hawkw in #7277 (comment)

@david-crespo david-crespo mentioned this issue Mar 14, 2025
7 tasks
@hawkw
Copy link
Member

hawkw commented Mar 14, 2025

I also notice that sometimes we use "a" in these, and other times we don't (at least "Get a physical disk" above). Maybe worth giving that a pass as well.

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

No branches or pull requests

2 participants