Skip to content

Guide for tofu openstack config usage - #19

Open
claudia-lola wants to merge 12 commits into
mainfrom
example-docs
Open

Guide for tofu openstack config usage#19
claudia-lola wants to merge 12 commits into
mainfrom
example-docs

Conversation

@claudia-lola

@claudia-lola claudia-lola commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

User guide for tofu-openstack-config

#21 should be merged first.

@claudia-lola
claudia-lola requested a review from sjpb July 15, 2026 10:33
L-Chams

This comment was marked as duplicate.

@L-Chams L-Chams left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Looking good, just a few grammatical changes I'd recommend.

Comment thread docs/guide.rst Outdated
Comment thread docs/guide.rst Outdated
@claudia-lola
claudia-lola requested a review from L-Chams July 15, 2026 14:14

@sjpb sjpb left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Think it needs some work:
a. Make it clear what's different from the README - maybe some stuff needs moving from there to here.
b. Currently it just shows structures, so you're still going to have to read the code to find out types and optional/required.

If you really want to add this much detail, I think it needs to be much more like the provider docs TBH, e.g. https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs/resources/compute_instance_v2.html

which has examples, optional/required, type information and descriptions. If you want to do that - which is useful - I'd be tempted to point an LLM at it as a first pass, then review carefully!

Comment thread docs/guide.rst Outdated
Comment thread docs/guide.rst Outdated
Comment thread docs/guide.rst Outdated
Comment thread docs/guide.rst Outdated
Comment thread docs/guide.rst Outdated
@claudia-lola
claudia-lola marked this pull request as draft July 21, 2026 14:16
@claudia-lola
claudia-lola requested a review from sjpb August 10, 2026 14:17
@claudia-lola
claudia-lola marked this pull request as ready for review August 10, 2026 14:27
Comment thread docs/shared_filesystem.md Outdated
@@ -0,0 +1,69 @@
> **WARNING:**

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Comment thread docs/guide.md Outdated
@@ -0,0 +1,28 @@
# Tofu OpenStack Config User Guide

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
# Tofu OpenStack Config User Guide
## Tofu OpenStack Config User Guide

for consistency

Comment thread README.md
- Note that the `--output` argument can be used to determine where files are
generated.

## VAST Support

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Should this be here? Why does it alone get a demo here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Moved to docs/vast.md but left a reference to this in the readme

Comment thread README.md
Comment thread docs/vast.md Outdated
- `end` (Required) number
- `client_ip_ranges` (Optional) list. Overrides `client_ranges`.

## Vast Provider

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Can we move this to the top? Logically you need to know about this before the resources

Comment thread docs/vast.md

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I thought you were going to signpost the shared_filesystems.md from here too? I can't find such?

Comment thread docs/vast.md Outdated
skip_ssl_verify = true
}

variable "vast_password" {

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I still think we should note that this ends up in state. It is not unique to this provider, but it is a massive potential gocha for a filesystem and e.g. the openstack provider does not store creds in state, so it is not obvious.

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