Added a table describing possible agent job types

[henryk-rychlik]

What

Added a table describing possible agent job types

Why

Customer asked about it and it seems this doesn't exist

Screenshots

---

Merge Checklist

If items do not apply to your changes, add (N/A) and mark them as complete.

Pull Request

• One or more labels describe the type of change (e.g. clarification) and associated product (e.g. HCP Terraform).
• Description links to related pull requests or issues, if any.

Content

• Redirects have been added for moved, renamed, or deleted pages. This requires a separate PR in the terraform-website repository redirects.next.js file.
• API documentation and the API Changelog have been updated.
• Links to related content where appropriate (e.g., API endpoints, permissions, etc.).
• Pages with related content are updated and link to this content when appropriate.
• Sidebar navigation files have been updated for added, deleted, reordered, or renamed pages.
• New pages have metadata (page name and description) at the top.
• New images are 2048 px wide. They have HashiCorp standard annotation color (#F92672) and format (rectangle with rounded corners), blurred sensitive details (e.g. credentials, usernames, user icons), and descriptive alt text in the markdown for accessibility.
• New code blocks have the correct syntax and line breaks to eliminate horizontal scroll bars.
• UI elements (button names, page names, etc.) are bolded.
• The Vercel website preview successfully deployed.

Reviews

• I or someone else reviewed the content for technical accuracy.
• I or someone else reviewed the content for typos, punctuation, spelling, and grammar.

[vercel]

@henryk-rychlik is attempting to deploy a commit to the HashiCorp Team on Vercel.

A member of the Team first needs to authorize it.

[hashicorp-cla-app]

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes

_{Have you signed the CLA already but the status is still pending? Recheck it.}

[hashicorp-cla-app]

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes

_{Have you signed the CLA already but the status is still pending? Recheck it.}

[rkoron007]

Left a comment about placement! Let me know what you think!

[rkoron007]

So, the page does describe the allowed job types below, but I agree a table could be a better way to display this! This doesn't feel like quite the place for this information though, since it doesn't really relate to request forwarding.

What do you think about placing it on the Manage agent pool page? If you like that, could you write write descriptive sentences for each Description, instead of using links? In docs we try to have all the information on one page if we can to avoid folks having to open many tabs to get the context they need.

[rkoron007]

Left a comment, please let me know if you have questions or anything doesn't feel good!

[rkoron007]

1. Sorry to nit, but could you remove the "Relevant documentation" column and instead make the descriptions full sentences with in-line references in the table? For accessibility reasons it's better to have links in context so that those using screen readers know where the link will lead here is another example of a table.

So, for example, in the first description:
The agent is [applying a run](/terraform/cli/commands/apply) in a workspace.

Let me know if that makes sense or if you have any other questions!

2. Do you think we need the "Terraform CLI equivalent" column if we have links to the accompanying docs? I'm inclined to say no, but curious what you think.