Re: first encounters with SELINUX, with some suggestions
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