[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: Selinux guide

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

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]