[BUG] Documentation is missing information on lack of support for symbolic file modes

[TimidRobot]

Description
The documentation is completely silent on the lack of symbolic file modes.

Steps to Reproduce the behavior

• 3005.1: https://docs.saltproject.io/en/3005/ref/states/all/salt.states.file.html
• latest: https://docs.saltproject.io/en/latest/ref/states/all/salt.states.file.html

Expected behavior
For example:

• salt/salt/states/file.py

  Lines 102 to 104 in b45c319

  	When using a mode that includes a leading zero you must wrap the
  	value in single quotes. If the value is not wrapped in quotes it
  	will be read by YAML as an integer and evaluated as an octal.

• Something like the following might be clearer:

  Symbolic file modes are not supported. When using an octal file mode that includes a leading zero, you must wrap the value in single quotes. If the value is not wrapped in quotes, it will be read by YAML as an integer and evaluated as an octal number instead of an octal file mode.

Additional context
Related:

• salt.states.file should support relative/symbolic modes #32681

[OrangeDog]

I think it's sufficiently clear that it means numerical mode only.

The permissions to set on this file, e.g. 644, 0775, or 4664.