Skip to content

Conversation

@rowansmithau
Copy link
Contributor

Noticed https://coder.com/docs/tutorials/best-practices/organizations#managing-organizations-at-scale linked to a github issue that has since been closed. This cleans up the docs page to make it clear the functionality has since been added.

Noticed https://coder.com/docs/tutorials/best-practices/organizations#managing-organizations-at-scale linked to a github issue that has since been closed. This cleans up the docs page to make it clear the functionality has since been added.

coder/terraform-provider-coderd#39
@rowansmithau rowansmithau self-assigned this Dec 16, 2025
@rowansmithau rowansmithau added the docs Area: coder.com/docs label Dec 16, 2025

Choose a reason for hiding this comment

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

🚫 [linkspector] reported by reviewdog 🐶
Cannot reach ../../reference/api/templates.md#update-template-metadata-by-id Status: 404 Cannot find section: #update-template-metadata-by-id in file: /home/runner/work/coder/coder/docs/reference/api/templates.md.

[through the API](../../reference/api/templates.md#update-template-metadata-by-id)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This seems unrelated to the changes in this PR.


- Issue
[coder/terraform-provider-coderd#39](https://github.com/coder/terraform-provider-coderd/issues/39)
Support for managing Organizations via the coderd Terrafom provider was introduced
Copy link
Member

Choose a reason for hiding this comment

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

I don't think anyone really cares about the release numbers here. it's documentation, people are here to see how it should be used and what they can do! we could add a code example, link to the docs on the terraform registry, etc. there are definitely better ways to use this space than to link to a list of github releases imo

Copy link
Contributor Author

Choose a reason for hiding this comment

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

removed the version information and provided a link to the docs which has usage examples. Don't think it's worth duplicating code examples into separate docs as at some point in future we will just end up with out of date information, which is the original problem this PR is trying to solve.

Updated the documentation to suggest using the coderd Terraform provider for managing organizations at scale and provided links for further resources and feature requests.
@rowansmithau rowansmithau requested a review from aslilac December 19, 2025 01:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Area: coder.com/docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants