# About

Canonical: https://googlecloudsamples.github.io/catalog/about/
Full guide for agents: [llms.txt](https://googlecloudsamples.github.io/catalog/llms.txt) · [all languages](https://googlecloudsamples.github.io/catalog/llms-full.txt) · [Python](https://googlecloudsamples.github.io/catalog/llms-full-python.txt) · [Node.js](https://googlecloudsamples.github.io/catalog/llms-full-node.txt) · [Java](https://googlecloudsamples.github.io/catalog/llms-full-java.txt) · [Go](https://googlecloudsamples.github.io/catalog/llms-full-go.txt) · [C#](https://googlecloudsamples.github.io/catalog/llms-full-csharp.txt) · [Ruby](https://googlecloudsamples.github.io/catalog/llms-full-ruby.txt) · [PHP](https://googlecloudsamples.github.io/catalog/llms-full-php.txt) · [Terraform](https://googlecloudsamples.github.io/catalog/llms-full-terraform.txt)

The **Cloud Samples Catalog** is the curated collection of code snippets, API operation samples, and multi-file application patterns that help developers learn and build with Google Cloud. Published across Google Cloud product documentation and the [Google Cloud Samples Browser](https://docs.cloud.google.com/docs/samples), these samples span Python, Node.js, Java, Go, C#, Ruby, PHP, Terraform, and more.

This site is the central hub for **sample designers, authors, maintainers, and reviewers** who build and maintain the catalog.

## Our Approach to Sample Engineering {#approach}

Great code samples do more than compile—they help developers succeed quickly and confidently. Every sample in the catalog is guided by three core practices:

* **Teach Through Code:** Each sample focuses on a single, well-defined cloud use case and includes clear comments explaining *why* recommended patterns are used.
* **Idiomatic Yet Consistent:** Samples follow the style conventions and tooling of each language community while maintaining consistent structure, copy-paste-callable functions, and predictable error handling across languages.
* **Governed & Maintainable:** Samples are treated as long-lived technical assets backed by co-located [metadata](https://googlecloudsamples.github.io/catalog/docs/effective-samples/metadata/) and automated integration tests so they stay reliable as APIs and client libraries evolve.

## How to Use This Site {#resources}

* **[Effective Samples Guide](https://googlecloudsamples.github.io/catalog/docs/effective-samples/):** Read the core principles and standards for [Authoring Samples](https://googlecloudsamples.github.io/catalog/docs/effective-samples/author-samples/), [API Operations](https://googlecloudsamples.github.io/catalog/docs/effective-samples/api-samples/), and [Metadata](https://googlecloudsamples.github.io/catalog/docs/effective-samples/metadata/).
* **[Samples Catalog Blog](https://googlecloudsamples.github.io/catalog/blog/):** Follow monthly release notes and deep dives into samples engineering practices.
* **[Explore the Catalog](https://docs.cloud.google.com/docs/samples):** Browse and search published Google Cloud code samples in the documentation.
