GoogleCloudPlatform
Top level docs are mis-placed or missing in most files
Per go/code-snippets-style#descriptive-top-level-comment, we should have top level comments that are placed outside of the region tags, to describe the snippets.
From a brief walk through some parts of the repo, I'm noticing most files don't have the top level comment at all, and I also a noticed a number of them, particularly in storage/transfer_service where they are wrongly placed inside the bounds of the region tag, causing them to render in the c.g.c docs, which doesn't seem is the desirable functionality.
Filed b/221461626. We can use the fixit week to poke at the snippet files that don't conform to the style, but until then it won't be an easy task to try and get this in line. It is also going to be hard to enforce this for new snippets, which the FR will help.
We're investigating further with the style changes. I'll report back once the samples steering committee discusses this.