Edit on GitHub
Report issue
Page history

Contribute a tutorial for the Google Cloud Community site

Author(s): @kopriva ,   Published: 2020-09-21

We welcome the contribution of any tutorial that shares knowledge about how to use Google Cloud.

The source for each tutorial is a Markdown file in the Google Cloud Community GitHub repository. Each tutorial may be accompanied by example source code and other assets alongside the tutorial in the repository.

Accept the Contributor License Agreement

For us to accept your contributions, we need you to sign the Contributor License Agreement (CLA):

  • If you are an individual writing original content and you own the intellectual property, then you sign an individual CLA.
  • If you work for a company that wants to allow you to contribute your work, then you sign a corporate CLA.

Contribute a tutorial

  1. Read the style guide before preparing your submission.

  2. Fork the github.com/GoogleCloudPlatform/community repository.

  3. Do one of the following to add the new tutorial file:

    • If you are contributing a single tutorial file with no supporting code or image files, then create a uniquely named .md file at the top level of the tutorials folder.
    • If you are contributing a tutorial with supporting code or image files, then create a new folder for your tutorial in the tutorials folder and create an index.md file at the top level of that subfolder.

    For details, see File organization and naming in GitHub.

  4. Copy the Markdown source contents of the tutorial template into your new Markdown file.

  5. Replace the template content with your own tutorial content, following the instructions in the template and style guide.

  6. Commit your changes and open a pull request.

    After you create a pull request, a reviewer reviews your submission. The reviewer will directly make some editorial and production changes to the tutorial to ensure that it follows the guidelines. The reviewer may also leave comments asking for changes or clarifications.

  7. Work with the reviewer to resolve any issues found during the review.

After your pull request is approved, the reviewer will merge the pull request. New tutorials and fixes are typically published to the Google Cloud Community site within a few days of pull requests being merged.

Submit a tutorial

Share step-by-step guides

Submit a tutorial

Request a tutorial

Ask for community help

Submit a request

View tutorials

Search Google Cloud tutorials

View tutorials

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.