Skip to content

Conversation

ADubhlaoich
Copy link
Contributor

@ADubhlaoich ADubhlaoich commented Oct 10, 2025

Proposed changes

This commit updates the issue templates into the repository, converting them from plain Markdown templates to interactive forms. It also updates the process documentation, re-organising them into topic groups and adding guidance on the level of desired detail for requests.

Checklist

Before sharing this pull request, I completed the following checklist:

Footnotes

  1. Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content.

This commit updates the issue templates into the repository, converting
them from plain Markdown templates to interactive forms. It also updates
the process documentation, re-organising them into topic groups and
adding guidance on the level of desired detail for requests.
@github-actions github-actions bot added tooling Back end, repository, Hugo, and all things not related to content process documentation Documentation related to how the repository or documention itself is managed. labels Oct 10, 2025
Copy link

Deploy Preview will be available once build job completes!

Name Link
😎 Deploy Preview https://frontdoor-test-docs.nginx.com/previews/docs/1287/


- If an issue involves changing a common noun, it may affect other work priorities
- If an issue is related to an upcoming release, it might need attention soon
- If an issue leaves users in an operable state, it requires intervention immediately
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I read "operable state" and I think "Oh, the software is still working with these docs, we can address the issue later"

Suggested change
- If an issue leaves users in an operable state, it requires intervention immediately
- If an issue leaves users with broken software, it requires intervention immediately

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inoperable?

Copy link
Contributor

@mjang mjang Oct 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

General comment:

IMO, it'd help focus the person who creates the issue to write this in the 2nd person / active voice

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

process documentation Documentation related to how the repository or documention itself is managed. tooling Back end, repository, Hugo, and all things not related to content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants