On Sun, 2008-01-06 at 23:43 +0900, Marc Wiriadisastra wrote: > On Sun, 2008-01-06 at 20:29 +0900, Marc Wiriadisastra wrote: > > Hey All, > > > > It seems like someone was eager awhile ago > > http://fedoraproject.org/wiki/Docs/Drafts/SELinux has been put up > > already. Should we use that link or change it to SELinuxGuide? > > > > I'm going to start creating the pages over the next week or so. I would > > like some input from everyone as to what to add. > > Just a quick email to say that I've added some stuff to the front page > with the intention and other basic information. Can people have a read > of it and comment so that we are all on the same page? > > If you think it requires further information or elaborating please post > here so it can be discussed and we can come to a consensus on what the > layout/content/methodology will be. I think you may want to revisit the Approach. For example, I don't think there are really any parallels between SELinux and MS Windows functionality. And if you assume that the user has no familiarity with UNIX/Linux concepts (which includes fundamentals), the guide needs to explain how to log in, how to open a terminal, etc. You might want to look at the existing documentation from Dan Walsh, et al., and try to condense that into a set of objectives you want the user to be able to achieve after reading each section of the documentation. This will give you better coverage than just throwing a set of use case "bricks" at the reader without seating them in a mortar of more fundamental practices. For example: A user who finishes reading this guide should be able to: 1. Understand how the Linux kernel, policy, and user tools work together to implement SELinux in Fedora 2. Understand the differences and interactions between legacy UNIX access controls and SELinux 3. Determine, set, and understand the operational mode of SELinux in a Fedora system 4. Determine, set, and understand object and file labels 5. Understand how to perform an automatic relabeling of a file system ... Using this sort of objective-based criterion, you can figure out what skills you need to cover, and usually in what order, to make a guide work, even if you have to condense information from a lot of different sources. Once you have a general organization like this, you can have it influence your outline for the doc. Hope this helps. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project: http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list mailing list fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list