Improve/Standardize alias

[thejcannon]

• key has aliases identifier and id (however I suspect y'all don't want to advertise the latter due to confusion with BUILDKITE_STEP_ID (not being the id)) so make sure identifier is listed as an alias
• Document the "not-UUID-like" restriction on all keys
• Add missing key field to Trigger and Wait step docs

[thejcannon]

Not sure why bloack_step.md uses <p> for all the table cells, but none of the others do 🤔

[gilesgas]

Good question @thejcannon , and thanks for pointing this out. I'm not sure why this is the case either.

I'll remove these <p></p> elements from this table then; this also appears to affect about 1/2 the HTML tables on this page.

[gilesgas]

Thanks!

[gilesgas]

Thanks very much for this PR update @thejcannon ! 🎉

These consistency updates are much appreciated! As mentioned above, I've removed the unnecessary <p></p> tag pairs and have added line breaks in the source after <br> (which I converted to <br/>) tags to improve the readability of this content in source.

Add missing key field to Trigger and Input step docs

I gather you meant Wait (instead of Input) here.

Anyway, while I'm pretty sure these are correct, I'll ask a colleague to provide a 2nd opinion first, and then'll merge these in! Thanks again

[thejcannon]

These consistency updates are much appreciated! As mentioned above, I've removed the unnecessary

tag pairs and have added line breaks in the source after
(which I converted to
) tags to improve the readability of this content in source.

Hmm I'm not seeing where you did this. Did you mean to do it on my branch? Or did you do this on main?

I gather you meant Wait (instead of Input) here.

Yup! Updated!

[gilesgas]

Thanks for your replies!

Hmm I'm not seeing where you did this. Did you mean to do it on my branch? Or did you do this on main?

They've been done (along with the removal of the unnecessary <p></p> tags) in a separate branch of a mirror of this docs repo. Once your PR is merged in, you'll see these commits pop up on main in this docs repo.

[gilesgas]

FYI @thejcannon , please don't worry about the merge conflicts in this working branch of yours.

We've just implemented some major restructuring of most of the Pipeline docs pages to make them follow a consistent URL pattern. These changes are now in the main branch of this repo and live in the Buildkite Docs. Therefore, the merge conflicts you see here have been resolved in the branch of our mirrored docs repo.

EDIT: I just wrote this comment in the event that you received a notification about merge conflicts. Having said that, this was only a fleeting state and this PR was merged without issue (along with the additional commits from the mirrored branch).