Document Windows App Control Feature

[jborean93]

This adds some documentation for a new feature added in Ansible 2.19.

[jborean93]

This is quite a large script so a literalinclude may not be the best idea. Any suggestions on how to potentially just link to the script this points to instead as a hyperlink?

[samccann]

@oraNod might have better ideas but see this line for how we did it in the past in the network getting started guide.

[oraNod]

The :download: directive that @samccann mentions is a good option. Although maybe it's not that informative and forces the reader to download a script and then go away from the docs and get off track.

You could do kind of a hybrid approach like this where you just include a portion of the script:

.. literalinclude:: powershell/New-AnsiblePowerShellSignature.ps1
   :lines: 11-21
   
You can view the complete script at `New-AnsiblePowerShellSignature.ps1 <path/to/powershell/New-AnsiblePowerShellSignature.ps1>`_.

Another approach could be creating a codeblock that highlights excerpts from the script and adds some comments. Although looking at the script it's well documented with examples so it might be hard to squeeze all of that into a codeblock. If it would be possible to give a really concise overview (maybe the Signs just the content include in Ansible and the ansible.windows collection example?) to give the reader a sense of how to use the script then follow the codeblock with either the download directive or a hyperlink.

[jborean93]

I originally had this as .. code-block:: xml to get some XML highlighting but it seems like we don't have it enabled/allowed in this repo. Happy with text here but if we want to enable xml I can always change this back.

[samccann]

hey I'm not sure how do enable xml?