Skip to content

1 - Add docs for basic stacks CRUD APIs #898

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

Closed
wants to merge 3 commits into from
Closed

Conversation

mrinalirao
Copy link
Contributor

@mrinalirao mrinalirao commented May 9, 2025

What

This PR adds API docs for basic stacks CRUD APIs.
https://hashicorp.atlassian.net/browse/TF-26174

NOTE: This PR will remain in draft as this cannot be merged before stacks goes GA
The API documentation has been divided into multiple PRs to simplify the review process. As each of these PRs is approved, it will be merged into this branch. Once everything is complete and ready for release, the final PR will be merged.

1. Create: POST /organizations/{organization_name}/stacks
2. List: GET /organizations/{organization_name}/stacks
3. Fetch: GET /stacks/{stack_id}
4. Update: PATCH /stacks/{stack_id}
5. Delete: DELETE /stacks/{stack_id}

Subsequent PRs will address other Stacks API's (for ease of review). The CHANGELOG will be updated once all the APIs have been added

Why

In preparation for stacks going GA, we need to document all the public facing API's for stacks

Screenshots

Screenshot 2025-05-09 at 2 41 29 pm

Merge Checklist

If items do not apply to your changes, add (N/A) and mark them as complete.

Pull Request

  • One or more labels describe the type of change (e.g. clarification) and associated product (e.g. HCP Terraform ).
  • Description links to related pull requests or issues, if any.

Content

  • Redirects have been added to website/redirects.js for moved, renamed, or deleted pages.
  • API documentation and the API Changelog have been updated.
  • Links to related content where appropriate (e.g., API endpoints, permissions, etc.).
  • Pages with related content are updated and link to this content when appropriate.
  • Sidebar navigation files have been updated for added, deleted, reordered, or renamed pages.
  • New pages have metadata (page name and description) at the top.
  • New images are 2048 px wide. They have HashiCorp standard annotation color (#F92672) and format (rectangle with rounded corners), blurred sensitive details (e.g. credentials, usernames, user icons), and descriptive alt text in the markdown for accessibility.
  • New code blocks have the correct syntax and line breaks to eliminate horizontal scroll bars.
  • UI elements (button names, page names, etc.) are bolded.
  • The Vercel website preview successfully deployed.

Reviews

  • I or someone else reviewed the content for technical accuracy.
  • I or someone else reviewed the content for typos, punctuation, spelling, and grammar.

Copy link

vercel bot commented May 9, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
terraform-docs-common ✅ Ready (Inspect) Visit Preview 💬 Add feedback May 28, 2025 4:24am

@rkoron007
Copy link
Contributor

Howdy @mrinalirao! I posted this on your other PRs, but as a reminder to myself:

Heads up that we will be migrating the content from terraform-docs-common into the UDR repo this week. I'm going through and merging any documentation PRs we can get in before migration, but for future work you'll need to recreate this PR over in the UDR repo after the migration is complete (and I'll leave a comment on all the associated Stacks PRs).

So a heads up, after the migration happens I'll close this PR and will let you know when you are good to recreate it! Apologies about the extra work you have to do though!

@rkoron007 rkoron007 added the notified-of-UDR A tag for tracking that this PR owner knows about UDR. label May 27, 2025
@rkoron007
Copy link
Contributor

Hello @mrinalirao!

The UDR migration has occurred, and the HCP Terraform documentation version now lives in the unified documentation repository. I'm going to close this PR since we are no longer serving this content from this repo, but please feel free to recreate your PR in the UDR repository within the HCP Terraform documentation and tag me if you need a review:
https://github.com/hashicorp/web-unified-docs/tree/main/content/terraform-docs-common/docs/cloud-docs

@rkoron007 rkoron007 closed this Jun 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
notified-of-UDR A tag for tracking that this PR owner knows about UDR.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants