From cbb9dce85438942f7b4f1b163756e311f54d75ea Mon Sep 17 00:00:00 2001
From: Tomo Suzuki <suztomo@gmail.com>
Date: Tue, 13 Dec 2022 15:49:58 -0500
Subject: [PATCH] docs: development with local gapic-generator-java (#1132)

* docs: development with local gapic-generator-java

* adding instruction for arbitrary target
---
 gapic-generator-java/DEVELOPMENT.md | 55 +++++++++++++++++++++++++----
 1 file changed, 48 insertions(+), 7 deletions(-)

diff --git a/gapic-generator-java/DEVELOPMENT.md b/gapic-generator-java/DEVELOPMENT.md
index 917e6dd634..5eb2740fa0 100644
--- a/gapic-generator-java/DEVELOPMENT.md
+++ b/gapic-generator-java/DEVELOPMENT.md
@@ -97,17 +97,17 @@
 
 ## Running the Plugin
 
-1.  Clone [googleapis](https://github.com/googleapis/googleapis) and
+1. Clone [googleapis](https://github.com/googleapis/googleapis) and
     [gapic-showcase](https://github.com/googleapis/gapic-showcase/).
 
-2.  Copy the protos from Showcase into googleapis/google/showcase.
+2. Copy the protos from Showcase into googleapis/google/showcase.
 
     ```sh
     mkdir googleapis/google/showcase
     cp -r gapic-showcase/schema/google/showcase/v1beta1 googleapis/google/showcase/v1beta1
     ```
 
-3.  Add the new microgenerator rules to
+3. Add the new microgenerator rules to
     `googleapis/google/showcase/v1beta1/BUILD.bazel` file as follows:
 
     ```python
@@ -162,8 +162,49 @@
     )
     ```
 
-4.  Build the new target.
+4. Point to local gapic-generator-java
+   
+   Normally, googleapis's build pulls in googleapis/gapic-generator-java from the
+   Internet:
+
+   ```
+   # Java microgenerator.
+   …
+   _gapic_generator_java_version = "2.1.0"
+   
+   http_archive(
+       name = "gapic_generator_java",
+       …
+       urls = ["https://github.com/googleapis/gapic-generator-java/archive/v%s.zip" % _gapic_generator_java_version],
+   )
+   ```
+
+   By replacing this portion using the built-in local_repository rule, you can mak
+   it refer to your local development repo:
+
+   ```
+   local_repository(
+     name = "gapic_generator_java",
+     path = "/home/<your id>/gapic-generator-java",
+   )
+   ```
+
+5. Build the new target.
+
+   ```sh
+   cd googleapis
+   bazel build //google/showcase/v1beta1:showcase_java_gapic
+   ```
+    
+   You can generate any client library based on the protos within googleapis.
+   You just need the name of the service within the `java_gapic_assembly_gradle_pkg`
+   rules within the service's `BUILD.bazel` file.
+   For instance, to run your local generator on the `speech`'s v2 service, you can
+   run:
+    
+   ```
+   bazel build //google/cloud/speech/v2:google-cloud-speech-v2-java
+   ```
+
+
 
-    ```sh
-    bazel build //google/showcase/v1beta1:showcase_java_gapic
-    ```