...
The current core security documentation has become very fragmented and out of date. It was assembled out of fragments of old documents with during the move to Wiki-based documentation in Fedora 3.0. The documentation for security related to aspects of many of security documentation in the individual APIs is fairly accurate but the there is little flow back to the security section of the core documentation. And the documentation is hard could be made easier to use. To help, we hope you will look at the current security documentation and list comment on deficiencies or areas that can be improved. Please, don't assume if you spot a problem you will be asked to fix it — we will be asking the person who has the most knowledge to do that (although help is always appreciated). Also, don't be concerned if you don't like to write — let's just get the accurate material and we can get the help of a technical writing to smooth it out (likely Dan).
...
- Security Options
- Section does not describe all the options with a quick indication of which should be used and when.
- Quick Start Guide
- A simple cookbook for a basic repository security set up.
- Repository XACML Enforcement
- How does it interact with other security components
- Insufficient examples for typical security policy
- FeSL
- Most of the documentation is incomplete
- Operational
- Institutional
Documentation Updates
...