Bug 138465
Summary: | docs are lacking or broken in some places | ||
---|---|---|---|
Product: | [Fedora] Fedora Documentation | Reporter: | Thomas Vander Stichele <thomas> |
Component: | selinux-faq | Assignee: | Karsten Wade <kwade> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Karsten Wade <kwade> |
Severity: | medium | Docs Contact: | |
Priority: | medium | ||
Version: | devel | CC: | kwade, walters |
Target Milestone: | --- | ||
Target Release: | --- | ||
Hardware: | All | ||
OS: | Linux | ||
URL: | http://fedora.redhat.com/docs/selinux-faq-fc3/index.html | ||
Whiteboard: | |||
Fixed In Version: | FC4 | Doc Type: | Bug Fix |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2005-12-28 00:57:48 UTC | Type: | --- |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: | |||
Bug Depends On: | |||
Bug Blocks: | 118757 |
Description
Thomas Vander Stichele
2004-11-09 14:26:54 UTC
Adding walters to cc as he's been working on some SELinux/Apache documentation. 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). All this has been long resolved, closing. |