Reduce the content on some Deploy section docs pages

PrefectHQ / prefect

Prefect is a workflow orchestration tool empowering developers to build, observe, and react to data pipelines

https://prefect.io

Apache License 2.0

15.29k stars 1.5k forks source link

Reduce the content on some Deploy section docs pages #14094

Open discdiver opened 1 week ago

discdiver commented 1 week ago

First check

[X] I added a descriptive title to this issue.
[X] I used GitHub search to find a similar request and didn't find it 😇

Describe the issue

Two docs pages that feel quite onerous in length:

Work pools and workers: 3.0rc/deploy/work-pools/control-runs Deploy flows to work pools and workers: 3.0rc/deploy/work-pools/prefect-deploy

Describe the proposed change

Shorten, break up, and/or simplify.

Additional context

No response

djsauble commented 1 week ago

As mentioned in Slack, I think Work pools and workers could be broken up into two pages: Work pools and Workers.

Deploy flows to work pools and workers doesn't seem quite as clear-cut, but one thought is to use a tabbed component when showing equivalent instructions for different deploy providers (e.g. Docker vs. Git vs. AWS et. al.).