Re: [gentoo-dev] Project-specific, but user/developer-interesting documentation

[Chris PeBenito]

On Thu, 2003-10-09 at 10:51, Sven Vermeulen wrote:
> 	http://www.gentoo.org/proj/en/hardened/selinux/selinux-x86-install.xml
> 		Gentoo SELinux Installation Guide [2]

> [2] Could this one be rewritten to show just the differences with a normal
>     installation? Currently, it is a snapshot of the installation manual with
>     some changes, but the installation manual has been changed several times
>     making the SELinux installation manual perhaps a bit outdated...

Well we used to do this, but it became confusing, because of conflicts
in each of the guides.  For example, you can only use ext2/3 in
SELinux.  Plus we need to show specific kernel config options.  Then
there's additional stuff at the end.

I've been concerned of it getting out of date, but theres not much we
can do other than to keep on it.  One solution is if we could come up
with a dynamic kind of guide.  Split up the guide into chapters, then
each project (or arch for that matter) could reuse whatever chapters are
common, and use their own modified chapters where needed.  That way
everyone would have up to date install guides.  It could be implemented
on top of the guide.xsl, kinda in the same way pauldv did the project
xml. </brainstorm>

I dont know how do-able that is, but it seems like a cool idea to me.

-- 
Chris PeBenito
<pebenito@g.o>
Developer, SELinux
Hardened Gentoo Linux
 
Public Key: http://pgp.mit.edu:11371/pks/lookup?op=get&search=0xE6AF9243
Key fingerprint = B0E6 877A 883F A57A 8E6A  CB00 BC8E E42D E6AF 9243