New publishing infrastructure documentation

[JohnTortugo]

Closes: #3599

Removed documentation about the old infrastructure and updated documentation about YAML Stages based publishing.

[markwilkie]

Super happy this exists!

[riarenas]

Aside from my comment about the differences section, this LGTM. Let's get someone else from the team that isn't involved in the infra to take a look with fresh eyes. That usually catches places where we have made assumptions that new people onboarding might not understand.

[markwilkie]

Thanks @JohnTortugo !

A few high level comments:

• Would it make sense to have the first section be "Here's what to do if you're a normal repo"? One would hope that this would be sufficient for most folks.
• What if the deprecated stuff was moved to a seperate doc? In a few months, folks won't even remember that there was a "before". But a link to "here's how it used to work" would be good, especially given servicing.
• Perhaps structure the rest of the doc w/ the same content, but in more of a reference style. Meaning, imagining that somebody is wondering how to do "x", what what "y" parameter means. I think most of it is there, but perhaps some additional organization.

Regardless, this looks quite complete. Thanks Cesar!

[JohnTortugo]

Thanks @JohnTortugo !

A few high level comments:

• Would it make sense to have the first section be "Here's what to do if you're a normal repo"? One would hope that this would be sufficient for most folks.
• What if the deprecated stuff was moved to a seperate doc? In a few months, folks won't even remember that there was a "before". But a link to "here's how it used to work" would be good, especially given servicing.
• Perhaps structure the rest of the doc w/ the same content, but in more of a reference style. Meaning, imagining that somebody is wondering how to do "x", what what "y" parameter means. I think most of it is there, but perhaps some additional organization.

Regardless, this looks quite complete. Thanks Cesar!

I think those are all good suggestions Mark. I changed the text to incorporate them. Thanks!

[JohnTortugo]

@riarenas @markwilkie - I think the doc is in much better shape now. Thanks for the suggestions.

@jcagme @adiaaida @garath @sunandabalu @mjanecke @MattGal @jonfortescue - PTAL if you have some time. I could benefit from a reviewer not so familiar with the work done.

[sunandabalu]

FAQ section is very helpful 👍

[missymessa]

Looks good. Like the FAQ section, and the tutorial appears to be fairly easy for someone to set up. Nice work :)

[JohnTortugo]

@markwilkie are you good to merge this?

[riarenas]

I just realized there's something we should probably add to this doc: A description of the purpose for each of the artifact types that we use: PackageArtifacts, BlobArtifacts, PdbArtifacts etc.

[JohnTortugo]

I just realized there's something we should probably add to this doc: A description of the purpose for each of the artifact types that we use: PackageArtifacts, BlobArtifacts, PdbArtifacts etc.

Done.

@markwilkie - can you please merge this? I don't have permission to do it.