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(mirromaker): added valid options for config #1722

Merged
merged 3 commits into from
May 14, 2024

Conversation

richard-joerger-aiven
Copy link
Contributor

offset_syncs_topic_location takes a string of "source" or "target" but the docs did not reflect that. The config also lacks a default and that was not captured. This adds the valid options and the lack of a default

About this change—what it does

offset_syncs_topic_location takes a string of "source" or "target" but the docs did not reflect that. The config also lacks a default and that was not captured. This adds the valid options and the lack of a default

Why this way

Based on the other configs, this is the approach that is used to document.

@richard-joerger-aiven richard-joerger-aiven requested a review from a team as a code owner May 10, 2024 16:43
@richard-joerger-aiven richard-joerger-aiven added the no changelog No changelog entries are required for this PR label May 10, 2024
@Serpentiel Serpentiel self-assigned this May 13, 2024
@Serpentiel
Copy link
Contributor

Serpentiel commented May 13, 2024

Hey, @richard-joerger-aiven! 👋

Thanks for your contribution. Could you please update your commit's message and PR title to align with Conventional Commits spec?

Here's an example of how it should be like in order to be complaint with the spec:

docs(mirrormaker): added valid options for config

(it should all be lowercase)

Please feel free to reach out if there are any questions!

Copy link
Contributor

@Serpentiel Serpentiel left a comment

Choose a reason for hiding this comment

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

  1. Comment above.

  2. Docs linter fails because the docs change is out of sync with the schema of the resource. Please mirror the proposed change to internal/sdkprovider/service/kafka/mirrormaker_replication_flow.go.

    • You can run make docs to automatically generate docs from the schema, but this is optional and you can instead keep the file that you've manually edited already.

@richard-joerger-aiven richard-joerger-aiven changed the title docs,minor: Added valid options for MM config docs(mirromaker): Added valid options for MM config May 13, 2024
@richard-joerger-aiven richard-joerger-aiven force-pushed the rjoerger-kafka-mm-docs-correction branch from db20610 to de79ec9 Compare May 14, 2024 14:06
@Serpentiel Serpentiel changed the title docs(mirromaker): Added valid options for MM config docs(mirromaker): added valid options for MM config May 14, 2024
offset_syncs_topic_location takes a string of "source" or "target" but
the docs did not reflect that. The config also lacks a default and that
was not captured. This adds the valid options and the lack of a default
Adding in the missing docs line so its the same across the resouce and
data source for mirrormaker_replication_flow
git diff on push shows extra spaces. Have to remove them as `make docs`
isn't working.
@Serpentiel Serpentiel force-pushed the rjoerger-kafka-mm-docs-correction branch from af0d33d to 5052bbc Compare May 14, 2024 16:11
Copy link
Contributor

@Serpentiel Serpentiel left a comment

Choose a reason for hiding this comment

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

lgtm

@Serpentiel Serpentiel enabled auto-merge (squash) May 14, 2024 16:12
@Serpentiel Serpentiel changed the title docs(mirromaker): added valid options for MM config docs(mirromaker): added valid options for config May 14, 2024
@Serpentiel Serpentiel merged commit 8a13378 into main May 14, 2024
10 checks passed
@Serpentiel Serpentiel deleted the rjoerger-kafka-mm-docs-correction branch May 14, 2024 16:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
no changelog No changelog entries are required for this PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants