[GH-ISSUE #176] Discussion: Update list organization and sections for clarity #5592

Closed
opened 2026-06-12 20:17:06 -05:00 by GiteaMirror · 3 comments
Owner

Originally created by @pauly4it on GitHub (Jul 31, 2022).
Original GitHub issue: https://github.com/shuaibiyy/awesome-tf/issues/176

Problem

In the course of the discussion on PR https://github.com/shuaibiyy/awesome-terraform/pull/171, it came up that the current list sections and organizations may no longer be adequate given the size the list has now grown to (a good problem to have!). For example, the Tools section has a mix of open source and free tools as well as SaaS products with and without free tiers.

This can be confusing for an end-user looking for a specific type of tool/product, but it can also be confusing for contributors to the list to determine where a new list addition should be placed.

Potential Approach

I took a look at the existing list and had a few ideas for how to reorganize the sections, at least as a first pass to set the stage for further organization. Here's how we could organize the list:

  • Contents
  • Legend
  • Official HashiCorp Terraform Resources
  • Community
  • Resources
    • Books
    • Tutorials and Blog Posts
      • Beginner Guides
      • How-To
      • Cloud Providers
        • Azure
        • AWS
        • Google Cloud
      • Multi-Environment Configuration
      • Security & Compliance
      • Testing & Troubleshooting
      • Writing Custom Providers
      • Miscellaneous
    • Videos
  • Providers
    • HashiCorp Supported Providers
    • Vendor Supported Providers
  • Community Modules
  • Tools & Services
    • General Tools & Services
    • Terraform Enterprise
    • Boilerplates
    • Testing
    • Libraries
    • Private Module Registries
    • Private Provider Registry
    • Editor Plugins
  • License
Originally created by @pauly4it on GitHub (Jul 31, 2022). Original GitHub issue: https://github.com/shuaibiyy/awesome-tf/issues/176 ## Problem In the course of the discussion on PR https://github.com/shuaibiyy/awesome-terraform/pull/171, it came up that the current list sections and organizations may no longer be adequate given the size the list has now grown to (a good problem to have!). For example, the Tools section has a mix of open source and free tools as well as SaaS products with and without free tiers. This can be confusing for an end-user looking for a specific type of tool/product, but it can also be confusing for contributors to the list to determine where a new list addition should be placed. ## Potential Approach I took a look at the existing list and had a few ideas for how to reorganize the sections, at least as a first pass to set the stage for further organization. Here's how we could organize the list: - Contents - Legend - Official HashiCorp Terraform Resources - Community - Resources - Books - Tutorials and Blog Posts - Beginner Guides - How-To - Cloud Providers - Azure - AWS - Google Cloud - Multi-Environment Configuration - Security & Compliance - Testing & Troubleshooting - Writing Custom Providers - Miscellaneous - Videos - Providers - HashiCorp Supported Providers - Vendor Supported Providers - Community Modules - Tools & Services - General Tools & Services - Terraform Enterprise - Boilerplates - Testing - Libraries - Private Module Registries - Private Provider Registry - Editor Plugins - License
Author
Owner

@pauly4it commented on GitHub (Jul 31, 2022):

@chenrui333 Opened this issue to continue our discussion and put up a draft PR as a proposal. I kept the majority of the tools in the "General Tools & Services" section for now, but I recommend breaking that up in follow-up PRs to avoid huge PR changes.

<!-- gh-comment-id:1200328916 --> @pauly4it commented on GitHub (Jul 31, 2022): @chenrui333 Opened this issue to continue our discussion and put up a draft PR as a proposal. I kept the majority of the tools in the "General Tools & Services" section for now, but I recommend breaking that up in follow-up PRs to avoid huge PR changes.
Author
Owner

@pauly4it commented on GitHub (Dec 8, 2022):

@chenrui333 just wanted to keep the conversation going. Like I said, this would be the first step to help organize the list, and then it'll (hopefully) be easier to improve organization after that.

<!-- gh-comment-id:1343474522 --> @pauly4it commented on GitHub (Dec 8, 2022): @chenrui333 just wanted to keep the conversation going. Like I said, this would be the first step to help organize the list, and then it'll (hopefully) be easier to improve organization after that.
Author
Owner

@chenrui333 commented on GitHub (Aug 3, 2023):

close this for now due to inactivity, feel free to create a new one.

<!-- gh-comment-id:1664727420 --> @chenrui333 commented on GitHub (Aug 3, 2023): close this for now due to inactivity, feel free to create a new one.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/awesome-tf#5592