Doc 654 add reference to queues on branch configurations

[clbarrell]

Purpose of this was to add Agent Queues as an alternative way of filtering pipelines and steps from being done – and where (agents) they are completed.

Then I added another example to the Queues page so it was clear the queue YAML attribute could be used as either root level or on a specific step.

Then I added a reference to branch filtering from the Queues page for completeness.

QUERY: I wasn't sure about referencing things as either 'build steps' or 'jobs'. It differs page to page. Welcome your input @mbelton-buildkite

[mbelton-buildkite]

I'll need to sleep on this one. It's useful information that I think we should include, but it's not clear if this is the right way to go about it.

I believe the proper place to draw this connection is on an explanation page that talks about controlling when and where jobs run on agents. But I don't believe that page exists.

Without that, I see three ways to incorporate it on these pages:

1. As a normal part of the intro content, like you have it. My concern with this is that it immediately suggests going to a different page before people get into the content of this page.
2. A callout in the intro content. This would help separate it from the regular content, but my concern is that it'll highlight it too much.
3. Add a new section at the end of the page, "Related concent/concepts." The drawback here is that you might miss it.

I'm leaning towards 3. What do you think?

[mbelton-buildkite]

I see three ways to incorporate it on these pages:

1. As a normal part of the intro content, like you have it. My concern with this is that it immediately suggests going to a different page before people get into the content of this page.
2. A callout in the intro content. This would help separate it from the regular content, but my concern is that it'll highlight it too much.
3. Add a new section at the end of the page, "Related concent/concepts." The drawback here is that you might miss it.

I think 3 is the way to go, with a new section "## Alternative methods" at the end of the page. I won't have time to look at it today, but can help tomorrow.

[clbarrell]

Thanks Will do 👍

[clbarrell]

can you re -review @mbelton-buildkite

[mbelton-buildkite]

One more tweak and then I think it'll be good to go