Security DocumentationSince security is a cross-cutting topic, security documentation must be kept accurate, timely and accessible to our users. Generally, security documentation has a section that brings together all the security-related subjects though often those subjects are individually discussed close to their closest usage context. Using a Wiki for documentation make this easier since we can cross-link and use excerpts to make the documentation authoring and maintenance much easier. Fedora 3.5 Security Documentation UpdatesThe central security documentation for Fedora has become fragmented and is out of date. For Fedora 3.5, the plan is to improve the documentation with an ongoing task of improving the documentation with each incremental release. This is the work of many hands since no-one has the complete story. In particular, security is very much involved with the use of the system so the participation of repository administrators and developers is a key aspect of this thread. The current core security documentation has become very fragmented and out of date. It was assembled out of fragments of old documents with the move to Wiki-based documentation in Fedora 3.0. The documentation for security related to aspects of many of the individual APIs is fairly accurate but the there is little flow back to the core documentation. And the documentation is hard to use. To help, we hope you will look at the current security documentation and list 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. 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). Deficiencies, Inaccuracies, and Improvements
|