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

Clarify spec.path in API docs #566

Merged
merged 1 commit into from
Feb 10, 2022
Merged

Conversation

kingdonb
Copy link
Member

@kingdonb kingdonb commented Feb 9, 2022

Fixes fluxcd/flux2#2357 - Docs accessibility

It's clear what was intended here if you know that Flux Kustomization has spec.path and GitRepository doesn't have any such a field, but that's presumptive about the user's knowledge. Let's not assume they've already learned and retained that.

+ in the `spec.path` of the Flux `Kustomization`

In #2357 it was noted that we mention `spec.path` but the code example
provided for context is a `GitRepository`. This is a leap too far, let's
provide this to better clarify the context.

Signed-off-by: Kingdon Barrett <[email protected]>
Copy link
Member

@stefanprodan stefanprodan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Thanks @kingdonb

@stefanprodan stefanprodan added the area/docs Documentation related issues and pull requests label Feb 10, 2022
@stefanprodan stefanprodan changed the title Clarify that spec.path is in the Kustomization Clarify that spec.path is in the API docs Feb 10, 2022
@stefanprodan stefanprodan changed the title Clarify that spec.path is in the API docs Clarify spec.path in API docs Feb 10, 2022
@stefanprodan stefanprodan merged commit e0488c9 into fluxcd:main Feb 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs Documentation related issues and pull requests
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation error
2 participants