Skip to content

Sample migration PR: test-20260319T095810#16131

Open
jskeet wants to merge 7 commits intogoogleapis:mainfrom
jskeet:test-20260319T095810
Open

Sample migration PR: test-20260319T095810#16131
jskeet wants to merge 7 commits intogoogleapis:mainfrom
jskeet:test-20260319T095810

Conversation

@jskeet
Copy link
Contributor

@jskeet jskeet commented Mar 19, 2026

This is a sample migration PR. It demonstrates what we expect to see during migration, hopefully in a way that is easy to review commit-by-commit.

Expected changes in the last commit:

  • Symlinks being converted into regular files for docs/README.rst. (We may try to do this before the migration.)
  • Harmless repo metadata changes:
    • Legacy fields being removed (e.g. samples, custom_content, sample_project_dir)
    • New API descriptions where there were no descriptions before
    • "repo" field corrections
    • Issue trackers being added
  • API descriptions in docs/README.rst where previously the repo metadata had no description
  • Memorystore product link being fixed to use https

Unexpected changes in the last commit, which need work:

  • New docs being created for some handwritten libraries
  • Unexpected repo metadata changes:
    • language and api_description being removed from handwritten libraries
  • Reformatting in a few packages (e.g. google-cloud-datastore)
  • Firestore handwritten docs being removed
  • Firestore docs being changed to favor firestore/admin
  • Monitoring dashboard docs changing links
  • Pub/Sub docs having an extra summary_overview

jskeet added 7 commits March 19, 2026 14:32
These are primarily due to legacylibrarian running the post-processor
in a clean context, whereas librarian runs it with existing
handwritten code in place.
This is just to get legacylibrarian up to HEAD in googleapis.

There will not be an equivalent of this commit in the real migration.
Generated with:

```sh
for file in packages/*/.repo-metadata.json
do
  jq 'del(.requires_billing)' $file | \
    jq 'del(.codeowner_team)' | \
    jq --sort-keys . | \
    jq 'del(..|select(. == ""))' | \
    jq --indent 4 > tmp.json
  truncate -s -1 tmp.json
  mv tmp.json $file
  sed -i 's/&/\\u0026/g' $file
done
```
(This won't be in the real "big" PR, as we'll already have a genuine
librarian.yaml file with the first two libraries.)
(This should include .librarian/config.yaml changes, and future test
PRs will do so.)
This was performed by running `nox -s format --no-venv --no-install`
and ignoring errors created by the few libraries which don't have a
"format" session.
See PR description for a breakdown of these.
@jskeet jskeet requested review from a team as code owners March 19, 2026 14:37
@jskeet jskeet added the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Mar 19, 2026
@snippet-bot
Copy link

snippet-bot bot commented Mar 19, 2026

Here is the summary of changes.

You are about to add 2 region tags.

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

  • Refresh this comment

@jskeet jskeet requested a review from daniel-sanche March 19, 2026 14:37
@gemini-code-assist
Copy link
Contributor

Warning

Gemini is experiencing higher than usual traffic and was unable to create the summary. Please try again in a few hours by commenting /gemini summary.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do not merge Indicates a pull request not ready for merge, due to either quality or timing.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant