From 7b183c3b027150cea449bf71b3fb8e8b8442c6ea Mon Sep 17 00:00:00 2001 From: Thomas Schultz Date: Sun, 18 Sep 2016 10:39:18 -0400 Subject: [PATCH 1/2] Add note about resource_manager projects being an alpha feature. --- docs/resource-manager-api.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/resource-manager-api.rst b/docs/resource-manager-api.rst index 87fab63c27f2..b809c2ce3f25 100644 --- a/docs/resource-manager-api.rst +++ b/docs/resource-manager-api.rst @@ -16,6 +16,16 @@ With this API, you can do the following: Don't forget to look at the :ref:`Authentication` section below. It's slightly different from the rest of this library. +.. note:: + + Alpha + + The projects.create() method is in the Alpha stage. It might be changed in + backward-incompatible ways and is not recommended for production use. It is + not subject to any SLA or deprecation policy. Access to this feature is + currently invite-only. For an invitation, contact our sales team at + https://cloud.google.com/contact. + Here's a quick example of the full life-cycle: .. code-block:: python From d4ed47f0e1b9c060c309109bd3e4c6875a204acd Mon Sep 17 00:00:00 2001 From: Thomas Schultz Date: Sun, 18 Sep 2016 16:28:48 -0400 Subject: [PATCH 2/2] Switch note to warning and add reference. --- docs/resource-manager-api.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/resource-manager-api.rst b/docs/resource-manager-api.rst index b809c2ce3f25..f74439763a10 100644 --- a/docs/resource-manager-api.rst +++ b/docs/resource-manager-api.rst @@ -16,16 +16,18 @@ With this API, you can do the following: Don't forget to look at the :ref:`Authentication` section below. It's slightly different from the rest of this library. -.. note:: +.. warning:: Alpha - The projects.create() method is in the Alpha stage. It might be changed in + The `projects.create() API method`_ is in the Alpha stage. It might be changed in backward-incompatible ways and is not recommended for production use. It is not subject to any SLA or deprecation policy. Access to this feature is currently invite-only. For an invitation, contact our sales team at https://cloud.google.com/contact. +.. _projects.create() API method: https://cloud.google.com/resource-manager/docs/creating-project + Here's a quick example of the full life-cycle: .. code-block:: python