Skip to content

Update guide – Add instructions for creating the Sandbox folder before cloud account onboarding #369

@skellish-turbot

Description

@skellish-turbot

Guide to be updated
Getting Started with AWS | Connect an AWS Account to Guardrails
URL: https://turbot.com/v5/docs/guides/getting-started/aws/connect-an-aws-account


Reason for update
The guide instructs users to select the "Sandbox" folder as the import location for their AWS account, but there are no prior instructions on creating this folder. This can cause confusion for new users, as the "Sandbox" folder does not exist by default. The same issue is present in the Azure and GCP onboarding guides, indicating a need for a foundational step that covers environment preparation.


Proposed changes

  • Add a new preliminary section or page (e.g., "Prepare the Guardrails Environment") before the cloud onboarding steps (AWS, Azure, GCP).
  • In this new section, provide instructions for creating the "Sandbox" folder under the Turbot root, including:
    • The purpose of the Sandbox folder (e.g., for testing, isolation, or best practices).
    • Step-by-step instructions and screenshots for creating the folder.
    • Any relevant naming conventions or organizational recommendations.
  • Update the "Connect an AWS Account," "Connect an Azure Subscription," and "Connect a GCP Project" guides to reference this new preparatory step, ensuring users are not confused when asked to select the "Sandbox" folder.
  • Optionally, clarify in the guides that if the Sandbox folder does not exist, it should be created before proceeding.

Metadata

Metadata

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions