From ba08b806b4455fe9a895b55f5ed02af58cb50a31 Mon Sep 17 00:00:00 2001 From: Min Zhu Date: Tue, 9 Jun 2026 11:21:21 -0400 Subject: [PATCH 1/3] doc: add section in developement.md for code generation with librarian --- DEVELOPMENT.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index 9fd27ec5903c..ff2ac32315db 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -1,6 +1,6 @@ # Monorepo Scoped Development Guide -This document outlines development workflows and build strategies when working with specific client libraries or modules in the `google-cloud-java` monorepo. +This document outlines development workflows, build strategies, and **code generation processes** when working with or managing client libraries in the `google-cloud-java` monorepo. --- @@ -51,3 +51,20 @@ mvn compile ``` Your IDE such as Intellij should also be able to import all the upstream dependencies at this moment. You can perform the same operations as you would in a normal project such as running unit tests, debugging and so on. + +--- + +## 3. Code Generation (Librarian) + +This repository uses **[Librarian](https://github.com/googleapis/librarian)** to generate code from API specifications. + +The configuration for Librarian in this repository is defined in the [librarian.yaml](librarian.yaml) file at the root. + +### Documentation & Guides + +For more information on how to use Librarian, configure generation, or troubleshoot issues, refer to the following guides: + +* **[Librarian GitHub Repository](https://github.com/googleapis/librarian)**: The main repository for the Librarian tool. +* **[Librarian Command Reference](https://pkg.go.dev/github.com/googleapis/librarian/cmd/librarian)**: Detailed documentation of `librarian` CLI commands. +* **[Librarian Configuration Schema](https://github.com/googleapis/librarian/blob/main/doc/config-schema.md)**: Guide to the structure and options available in `librarian.yaml`. +* **[go/g3doc-sdk-librarian](https://go/g3doc-sdk-librarian)** (Internal): Internal documentation for code generate schedules and local development workflows. From d3671fa599b387f2685baa28e37b31825ec1b191 Mon Sep 17 00:00:00 2001 From: Min Zhu Date: Tue, 9 Jun 2026 12:28:26 -0400 Subject: [PATCH 2/3] wording --- DEVELOPMENT.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index ff2ac32315db..a4a15941d94f 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -67,4 +67,4 @@ For more information on how to use Librarian, configure generation, or troublesh * **[Librarian GitHub Repository](https://github.com/googleapis/librarian)**: The main repository for the Librarian tool. * **[Librarian Command Reference](https://pkg.go.dev/github.com/googleapis/librarian/cmd/librarian)**: Detailed documentation of `librarian` CLI commands. * **[Librarian Configuration Schema](https://github.com/googleapis/librarian/blob/main/doc/config-schema.md)**: Guide to the structure and options available in `librarian.yaml`. -* **[go/g3doc-sdk-librarian](https://go/g3doc-sdk-librarian)** (Internal): Internal documentation for code generate schedules and local development workflows. +* **[go/g3doc-sdk-librarian](https://go/g3doc-sdk-librarian)** (Internal): Internal documentation for code generation schedules and local development workflows. From 683c3d63a5a0baf5b1ec78e086df9407d132aafb Mon Sep 17 00:00:00 2001 From: Min Zhu Date: Tue, 9 Jun 2026 12:29:21 -0400 Subject: [PATCH 3/3] rm unneeded bold --- DEVELOPMENT.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index a4a15941d94f..8b50fc7aa076 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -1,6 +1,6 @@ # Monorepo Scoped Development Guide -This document outlines development workflows, build strategies, and **code generation processes** when working with or managing client libraries in the `google-cloud-java` monorepo. +This document outlines development workflows, build strategies, and code generation processes when working with or managing client libraries in the `google-cloud-java` monorepo. ---