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

TF Plugin Docs - migrating to new structure #2470

Merged
merged 9 commits into from
Apr 25, 2024
Merged

TF Plugin Docs - migrating to new structure #2470

merged 9 commits into from
Apr 25, 2024

Conversation

sheneska
Copy link
Contributor

@sheneska sheneska commented Apr 18, 2024

Description

This PR covers the following:

  • migrates files from the legacy structure (docs/r) to the tfplugindocs supported templates/ structure
  • generates templated files for each resource & data source as well as example.tf files

Release Note

Release note for CHANGELOG:

...

References

Community Note

  • Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
  • If you are interested in working on this issue or have submitted a pull request, please leave a comment

Copy link
Contributor

@arybolovlev arybolovlev left a comment

Choose a reason for hiding this comment

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

I have left a few comments, could you please take a look? Most of them apply to all files in this PR, so I picked up only one and commented there.

One more thing that I have noticed -- doc-gen does not pick up default values. Do you know if there are plans to fix that? It might be crucial for some resources and timeouts.

All in all, great efforts, thank you!

templates/resources/secret_v1.md.tmpl Outdated Show resolved Hide resolved
templates/resources/secret_v1.md.tmpl Outdated Show resolved Hide resolved
templates/resources/namespace_v1.md.tmpl Show resolved Hide resolved
templates/resources/namespace_v1.md.tmpl Show resolved Hide resolved
kubernetes/resource_kubernetes_namespace_v1.go Outdated Show resolved Hide resolved
templates/resources/namespace_v1.md.tmpl Outdated Show resolved Hide resolved
@sheneska sheneska changed the title TF Plugin Docs - namespace & RunTime Class TF Plugin Docs - migrating to new structure Apr 20, 2024
Copy link
Member

@SarahFrench SarahFrench left a comment

Choose a reason for hiding this comment

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

👋 Hi Sheneska, I saw your post on Slack and took a look at the problem.

It looks like you need to update these files to reflect the new locations of the markdown files:

@arybolovlev arybolovlev marked this pull request as ready for review April 25, 2024 15:53
@arybolovlev arybolovlev requested a review from a team as a code owner April 25, 2024 15:53
@sheneska sheneska merged commit c746a84 into main Apr 25, 2024
8 checks passed
@sheneska sheneska deleted the tf-plugin-docs branch April 25, 2024 15:56
dduportal referenced this pull request in jenkins-infra/azure May 10, 2024
<Actions>
<action
id="bcd9b70d7c1eb1e07eb5ad8a958f18dc1bbd81461ee1a2604adeea46e3148a47">
        <h3>Bump Terraform `kubernetes` provider version</h3>
<details
id="1d9343c012f5434ac9fe8a98135bae3667b399259be16d9b14302ea3bd424a24">
            <summary>Update Terraform lock file</summary>
<p>changes detected:&#xA;&#x9;&#34;hashicorp/kubernetes&#34; updated
from &#34;2.29.0&#34; to &#34;2.30.0&#34; in file
&#34;.terraform.lock.hcl&#34;</p>
            <details>
                <summary>2.30.0</summary>
<pre>Changelog retrieved
from:&#xA;&#x9;https://github.com/hashicorp/terraform-provider-kubernetes/releases/tag/v2.30.0&#xA;BUG
FIXES:&#xD;&#xA;&#xD;&#xA;* `data_source/kubernetes_resources`: fix an
issue where the provider exit with an error when the data source
`kubernetes_resources` receives multiple Kubernetes objects containing
tuples with different numbers of elements.
[[GH-2372](https://github.com/hashicorp/terraform-provider-kubernetes/issues/2372)]&#xD;&#xA;*
`kubernetes_manifest`: fix issue preventing KUBE_PROXY_URL environment
variable from being used in client configuration (#1733)
[[GH-2485](https://github.com/hashicorp/terraform-provider-kubernetes/issues/2485)]&#xD;&#xA;*
`resource/kubernetes_node_taint`: Fix the error check for nonexistant
nodes so that terraform does not fail if there is a taint in the state
file for a node that has been deleted.
[[GH-2402](https://github.com/hashicorp/terraform-provider-kubernetes/issues/2402)]&#xD;&#xA;&#xD;&#xA;DOCS:&#xD;&#xA;&#xD;&#xA;*
Migrate legacy structure to new tfplugindocs template structure
[[GH-2470](https://github.com/hashicorp/terraform-provider-kubernetes/issues/2470)]&#xD;&#xA;</pre>
            </details>
        </details>
<a
href="https://infra.ci.jenkins.io/job/updatecli/job/azure/job/main/161/">Jenkins
pipeline link</a>
    </action>
</Actions>

---

<table>
  <tr>
    <td width="77">
<img src="https://www.updatecli.io/images/updatecli.png" alt="Updatecli
logo" width="50" height="50">
    </td>
    <td>
      <p>
Created automatically by <a
href="https://www.updatecli.io/">Updatecli</a>
      </p>
      <details><summary>Options:</summary>
        <br />
<p>Most of Updatecli configuration is done via <a
href="https://www.updatecli.io/docs/prologue/quick-start/">its
manifest(s)</a>.</p>
        <ul>
<li>If you close this pull request, Updatecli will automatically reopen
it, the next time it runs.</li>
<li>If you close this pull request and delete the base branch, Updatecli
will automatically recreate it, erasing all previous commits made.</li>
        </ul>
        <p>
Feel free to report any issues at <a
href="https://github.com/updatecli/updatecli/issues">github.com/updatecli/updatecli</a>.<br
/>
If you find this tool useful, do not hesitate to star <a
href="https://github.com/updatecli/updatecli/stargazers">our GitHub
repository</a> as a sign of appreciation, and/or to tell us directly on
our <a
href="https://matrix.to/#/#Updatecli_community:gitter.im">chat</a>!
        </p>
      </details>
    </td>
  </tr>
</table>

Co-authored-by: Jenkins Infra Bot (updatecli) <60776566+jenkins-infra-bot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants