# User documentation requests

If you are working on a change (bugfix, enhancement, or feature) which
would benefit from user-facing documentation, please use the
`user-doc-firefox` flag to request it.

This flag can be modified by anyone with `EDITBUGS` privileges.

The default value of the flag is `---`.

If the bug needs user-facing documentation, set the flag to
`docs-needed`. This flag will be monitored by the support.mozilla.org
(SUMO) team.

Once the docs are ready to be published, set the flag to
`docs-completed`.

If it’s determined that documentation is not need after setting the flag
to `docs-needed`, update the flag to `none-needed` so we know that
it’s been reviewed.

## Summary

| From        |     | To             |
| ----------- | --- | -------------- |
| —           | to  | none-needed    |
| —           | to  | docs-needed    |
| docs-needed | to  | none-needed    |
| docs-needed | to  | docs-completed |

## Notes

A flag is used instead of the old keywords because flags can be
restricted to a subset of products and components.