Skip to content

Commit a6b94f7

Browse files
ryanseysryanseys
committed
Merge pull request #571 from jgeewax/overview-docs
Factored out service overview docs into separate files.
2 parents 244c0d5 + 9c90f19 commit a6b94f7

File tree

5 files changed

+45
-49
lines changed

5 files changed

+45
-49
lines changed

‎docs/site/components/docs/bigquery-overview.html

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<h3>BigQuery Overview</h3>
2+
<p>
3+
The object returned from <code>gcloud.bigquery</code> gives you complete access to and control of your BigQuery datasets. You can work with existing ones, by using the <code>dataset</code> method, or create new ones with <code>createDataset</code>.
4+
</p>
5+
<p>
6+
To learn more about BigQuery, see <a href="https://cloud.google.com/bigquery/what-is-bigquery">What is BigQuery?</a>
7+
</p>

‎docs/site/components/docs/datastore-overview.html

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<h3>Datastore Overview</h3>
2+
<p>
3+
The <code>gcloud.datastore</code> object gives you some convenience methods, as well as exposes a <code>dataset</code> function. This will allow you to create a <code>dataset</code>, which is the object from which you will interact with the Google Cloud Datastore.
4+
</p>
5+
<p>
6+
To learn more about Datastore, read the <a href="https://cloud.google.com/datastore/docs/concepts/overview">Google Cloud Datastore Concepts Overview</a>.
7+
</p>
8+

‎docs/site/components/docs/docs.html

Lines changed: 3 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -64,55 +64,9 @@ <h3 class="sub-heading">
6464
</article>
6565
<hr>
6666

67-
<article ng-if="isActiveDoc('bigquery')">
68-
<h3>BigQuery Overview</h3>
69-
<p>
70-
The object returned from <code>gcloud.bigquery</code> gives you complete access to and control of your BigQuery datasets. You can work with existing ones, by using the <code>dataset</code> method, or create new ones with <code>createDataset</code>.
71-
</p>
72-
<p>
73-
To learn more about BigQuery, see <a href="https://cloud.google.com/bigquery/what-is-bigquery">What is BigQuery?</a>
74-
</p>
75-
</article>
76-
77-
<article ng-if="isActiveDoc('datastore')">
78-
<h3>Datastore Overview</h3>
79-
<p>
80-
The <code>gcloud.datastore</code> object gives you some convenience methods, as well as exposes a <code>dataset</code> function. This will allow you to create a <code>dataset</code>, which is the object from which you will interact with the Google Cloud Datastore.
81-
</p>
82-
<p>
83-
To learn more about Datastore, read the <a href="https://cloud.google.com/datastore/docs/concepts/overview">Google Cloud Datastore Concepts Overview</a>.
84-
</p>
85-
</article>
86-
87-
<article ng-if="isActiveDoc('pubsub')">
88-
<h3>Pub/Sub Overview</h3>
89-
<p class="notice">
90-
Google Cloud Pub/Sub is in Alpha status. As a result, 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.
91-
</p>
92-
<p>
93-
The <code>gcloud.pubsub</code> method will return a <code>pubsub</code> object, allowing you to create topics, publish messages, subscribe to topics, and more.
94-
</p>
95-
<p>
96-
To learn more about Pub/Sub, see the <a href="https://developers.google.com/pubsub/overview">Google Cloud Pub/Sub overview</a>.
97-
</p>
98-
</article>
99-
100-
<article ng-if="isActiveDoc('storage')">
101-
<h3>Storage Overview</h3>
102-
<p>
103-
The <code>gcloud.storage</code> object contains a <code>bucket</code> function, which is how you will interact with your Google Cloud Storage bucket.
104-
</p>
105-
<p>
106-
To learn more about Cloud Storage, see the <a href="https://cloud.google.com/storage/docs/overview">Google Cloud Storage overview</a>.
107-
</p>
108-
109-
<h4>ACLs</h4>
110-
<p>
111-
Google Cloud Storage uses access control lists (ACLs) to manage object and bucket access. ACLs are the mechanism you use to share files with other users and allow other users to access your buckets and files.
112-
</p>
113-
<p>
114-
To learn more about ACLs, read this overview on <a href="https://cloud.google.com/storage/docs/access-control">Access Control</a>.
115-
</p>
67+
<article ng-repeat="service in ['bigquery', 'datastore', 'pubsub', 'storage']"
68+
ng-if="isActiveDoc(service)"
69+
ng-include="'/site/components/docs/' + service + '-overview.html'">
11670
</article>
11771

11872
<article

‎docs/site/components/docs/pubsub-overview.html

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
<h3>Pub/Sub Overview</h3>
2+
<p class="notice">
3+
Google Cloud Pub/Sub is in Alpha status. As a result, 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.
4+
</p>
5+
<p>
6+
The <code>gcloud.pubsub</code> method will return a <code>pubsub</code> object, allowing you to create topics, publish messages, subscribe to topics, and more.
7+
</p>
8+
<p>
9+
To learn more about Pub/Sub, see the <a href="https://developers.google.com/pubsub/overview">Google Cloud Pub/Sub overview</a>.
10+
</p>
11+

‎docs/site/components/docs/storage-overview.html

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
<h3>Storage Overview</h3>
2+
<p>
3+
The <code>gcloud.storage</code> object contains a <code>bucket</code> function, which is how you will interact with your Google Cloud Storage bucket.
4+
</p>
5+
<p>
6+
To learn more about Cloud Storage, see the <a href="https://cloud.google.com/storage/docs/overview">Google Cloud Storage overview</a>.
7+
</p>
8+
9+
<h4>ACLs</h4>
10+
<p>
11+
Google Cloud Storage uses access control lists (ACLs) to manage object and bucket access. ACLs are the mechanism you use to share files with other users and allow other users to access your buckets and files.
12+
</p>
13+
<p>
14+
To learn more about ACLs, read this overview on <a href="https://cloud.google.com/storage/docs/access-control">Access Control</a>.
15+
</p>
16+

0 commit comments

Comments
 (0)