Ask contributors to put library samples in library repository (GoogleCloudPlatform#4298)

busunkim96 · web-flow · commit a07d1167da06 · 2020-07-15T14:39:42.000-07:00
diff --git a/AUTHORING_GUIDE.md b/AUTHORING_GUIDE.md
@@ -22,7 +22,15 @@ This section covers guidelines for Python samples. Note that
 
 ### Folder Location
 
-Each sample should be in a folder under the top-level folder of
+Samples that primarily show the use of one client library should be placed in the 
+client library repository. Other samples should be placed in this repository
+`python-docs-samples`.
+
+**Library repositories:** Each sample should be in the top-level samples folder `samples`
+in the client library repository. See the [Text-to-Speech samples](https://github.com/googleapis/python-texttospeech/tree/master/samples)
+for an example.
+
+**python-docs-samples:** Each sample should be in a folder under the top-level folder of
 [python-docs-samples](https://github.com/GoogleCloudPlatform/python-docs-samples)
 that corresponds to the Google Cloud service or API used by the sample.
 For example, a sample demonstrating how to work with BigTable should be
@@ -472,15 +480,22 @@ Please read the [MAC Setup Guide](https://github.com/GoogleCloudPlatform/python-
 
 ### Running tests with nox
 
-Automated testing for samples in `python-docs-samples` is managed by
+Automated testing for samples is managed by
 [nox](https://nox.readthedocs.io). Nox allows us to run a variety of tests,
 including the flake8 linter, Python 2.7, Python 3.x, and App Engine tests,
 as well as automated README generation.
 
-__Note:__ As a temporary workaround, each project currently uses first
+__Note:__ 
+
+**Library repositories:** If you are working on an existing project, a `noxfile.py` will already exist.
+For new samples, create a new `noxfile.py` and paste the contents of
+[noxfile-template.py](https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/noxfile-template.py)
+
+**python-docs-samples:** As a temporary workaround, each project currently uses first
 `noxfile-template.py` found in a parent folder above the current sample. In
 order to simulate this locally, you need to copy + rename the parent
-`noxfile-template.py` as `noxfile.py` in the folder of the project (containing the `requirements.txt` for the file) you want to
+`noxfile-template.py` as `noxfile.py` in the folder of the project (containing the `requirements.txt` for the file).
+
 ```console
 cd python-docs-samples
 cp noxfile-template.py PATH/TO/YOUR/PROJECT/noxfile.py
@@ -516,6 +531,8 @@ nox -s py-3.7 -- snippets_test.py:test_list_blobs
 
 ### Running tests with Docker
 
+__Note__: This is currently only available for samples in `python-docs-samples`.
+
 If you have [Docker](https://www.docker.com) installed and runnable by
 the local user, you can use `scripts/run_tests_local.sh` helper script
 to run the tests. For example, let's say you want to modify the code
