...

Text file src/cloud.google.com/go/internal/README.md

Documentation: cloud.google.com/go/internal

     1# Internal
     2
     3This directory contains internal code for cloud.google.com/go packages.
     4
     5## .repo-metadata-full.json
     6
     7`.repo-metadata-full.json` contains metadata about the packages in this repo. It
     8is generated by `internal/gapicgen/generator`. It's processed by external tools
     9to build lists of all of the packages.
    10
    11Don't make breaking changes to the format without consulting with the external
    12tools.
    13
    14One day, we may want to create individual `.repo-metadata.json` files next to
    15each package, which is the pattern followed by some other languages. External
    16tools would then talk to pkg.go.dev or some other service to get the overall
    17list of packages and use the `.repo-metadata.json` files to get the additional
    18metadata required. For now, `.repo-metadata-full.json` includes everything.
    19
    20### Updating OwlBot SHA
    21
    22You may want to manually update the which version of the post-processor will be
    23used -- to do this you need to update the SHA in the OwlBot lock file.
    24
    25See the [postprocessor/README](postprocessor/README.md) for detailed
    26instructions.
    27
    28*Note*: OwlBot will eventually open a pull request to update this value if it
    29discovers a new version of the container.

View as plain text