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

Fixed typos #391

Merged
merged 1 commit into from
Mar 19, 2024
Merged

Fixed typos #391

merged 1 commit into from
Mar 19, 2024

Conversation

lzandman
Copy link
Contributor

Fixed some typos I noticed.

@lzandman lzandman requested a review from a team as a code owner March 14, 2024 16:58
@hashicorp-cla
Copy link

hashicorp-cla commented Mar 14, 2024

CLA assistant check
All committers have signed the CLA.

@lzandman
Copy link
Contributor Author

Why does that validation step fail? Did I alter some files that I shouldn't have?

@lbajolet-hashicorp
Copy link
Contributor

lbajolet-hashicorp commented Mar 15, 2024

Hi @lzandman,

The files in .web-docs are generated from a combination of text in the docs directory, and partials extracted from the Go code documentation (packer-sdc is the component responsible for that).

So in this case yes, those changes you made to the files in .web-docs are overwritten by make generate, which we run in CI so we always have up-to-date documentation.

I suggest you run the command locally and search for the source of those typos in the code, if fixed here, the generation should stabilise.
Let me know if you need help!

Thanks for the patch.

@lzandman
Copy link
Contributor Author

I'm not able to do a make generate on the system I currently work on. I did revert all files in the .web-docs folder.

Copy link
Contributor

@lbajolet-hashicorp lbajolet-hashicorp left a comment

Choose a reason for hiding this comment

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

Hi @lzandman,

Thanks for the update; I've taken the liberty to run make generate to update the .web-docs from your changes, hopefully the CI should be green.

If it succeeds, I'll merge the PR today.

Thanks again!

@lzandman
Copy link
Contributor Author

lzandman commented Mar 19, 2024

Really weird how this PR's diff view still shows changed files in .web-docs. I'm pretty sure my branch doesn't. Is the build that's currently running (actions) generating those files and adding them to this PR?

In any case, I see all validations have been successfully passed!

@lbajolet-hashicorp
Copy link
Contributor

Oh maybe I wasn't explicit when I commented sorry about that.

Everything in .web-docs is versioned, the documentation for the plugin is extracted from this directory.
We have a check in our pipelines for making sure the .web-docs generated data is up-to-date compared to the code (since comments are extracted as partials), and if there's a discrepancy between what was committed and what is generated in CI, this means that the .web-docs should be generated and committed to git.

Hope that clears-up that misunderstanding!

@lbajolet-hashicorp lbajolet-hashicorp merged commit 627a05a into hashicorp:main Mar 19, 2024
12 checks passed
@lzandman
Copy link
Contributor Author

Ah, I understand.

@lzandman lzandman deleted the fix-typos branch March 19, 2024 16:08
Copy link
Contributor

@lbajolet-hashicorp lbajolet-hashicorp left a comment

Choose a reason for hiding this comment

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

LGTM!

@lzandman lzandman mentioned this pull request Oct 3, 2024
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.

3 participants