first encounters with SELINUX, with some suggestions

Karsten Wade kwade at redhat.com
Tue Nov 9 18:25:09 UTC 2004


On Tue, 2004-11-09 at 06:33, Thomas Vander Stichele wrote:
> On Tue, 2004-11-09 at 07:47 -0500, Paul W. Frields wrote:
> > On Tue, 2004-11-09 at 07:12, Thomas Vander Stichele wrote:
> > [...snip...]
> > > I read through a few howto's, including
> > > http://fedora.redhat.com/docs/selinux-faq-fc3/index.html
> > > (which has all of its internal links broken, can somebody please fix
> > > this, it's quite annoying !) ...
> > [...snip...]
> > 
> > Please file a bug in Bugzilla against component "fedora-docs," and note
> > some of the specific links that are broken. Thank you!
> 
> Done,
> https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=138465

The SELinux FAQ specific bugs are now fixed, and should be live within
the hour.

## snipped from the bug report

Thanks for bringing these to our attention.  Here are the quick fixes:

> The "docs" link below that links to the docs as a project, 
> not to docs.  Maybe not that bad, but confusing.

This is a usability issue we need to consider.  Perhaps renaming the
navigation to be Projects > Docs Project?  We regularly receive
traffic on fedora-docs-list from people looking for documentation,
whereas the Docs Project is for creating documentation.  Fine line. 
More thought needed here.

> The docs link on the left links to docs, where SELINUX is listed,
> and the link mentions that it is for FC3 test 2

Oops.  Fixed, should be live within the hour.

> When you click it, the docs say it is for test *3*

When this document was updated last (22-OCT-2004), it was current for
test3.  With the release yesterday of FC3 final, I have updated the
title to say just Fedora Core 3.  This should be live within the hour.

> all internal links in that doc are broken

Recently known issue due to a problematic script on fedora.redhat.com,
fixed this morning, changes are already live.

> some commands in that doc do not work: fixfiles, audit2allow

Yes, there was an instance where fixfiles is shown using a directory
path.  This has been fixed, and language has been added to make the
usage for fixfiles and audit2allow more clear.

> the document is more of a FAQ than a Howto, a simple "getting 
> started" would help a lot.

The Fedora Documentation Project needs writers.  If you know of anyone
who is interested in writing a kind of getting started guide, send
them to fedora-docs-list, and we'll get them started.

Soon for release is a tutorial on using Apache and SELinux.  When this
is ready, we'll announce it on the relevant mailing lists.

This bug has been set to block bug #118757, which is the tracker bug
for reports against the SELinux FAQ.

The version reported against was selinux-faq-1.3-2
(2004-10-22-T16:20-0800).  Current version is selinux-faq-1.3-3
(2004-11-09-T16:20-0800).

## snip end

-- 
Karsten Wade, RHCE, Tech Writer
a lemon is just a melon in disguise
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115  5F1B D992 0E06 AD0E 0C41




More information about the fedora-devel-list mailing list