| Summary: | Convert Gentoo Security Guide to Security Handbook | ||
|---|---|---|---|
| Product: | [OLD] Docs-user | Reporter: | Eric Brown <eric.brown> |
| Component: | Gentoo Security Guide | Assignee: | Xavier Neys (RETIRED) <neysx> |
| Status: | RESOLVED FIXED | ||
| Severity: | enhancement | CC: | curtis119, docs-team, iyosifov |
| Priority: | High | ||
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Package list: | Runtime testing required: | --- | |
| Attachments: |
Gentoo Linux Security Handbook
update for metadoc.xml update for gentoo-security guide update uri in /security/en/index.xml Security Handbook w/changes |
||
|
Description
Eric Brown
2004-11-14 14:42:55 UTC
It's certainly worth converting into a handbook style. It's indeed getting tremendously long. This might scare away users while it's indeed a very powerful and interesting document. I'm going to use this to track suggestions on the guide... tseng reported that /lib/ld-linux.so.2 would run files on partitions marked as noexec.. we should also consider using files on other partitions to execute those restricted files, or the possibility of copying them to other places.. Actually I rather not use a bug to track stuff unless it's non-disputable. Let this bug remain for it's original report: creating a handbook-format for it. Created attachment 60253 [details]
Gentoo Linux Security Handbook
I converted the /doc/en/gentoo-security.xml guide into a handbook. It should go
in /doc/en/security/
The files are attached as a tarball. Also attached are diffs for
/security/en/index.xml | /doc/en/gentoo-security.xml | /doc/en/metadoc.xml
Created attachment 60254 [details, diff]
update for metadoc.xml
This updates the location of the security handbook in the <files> section of
/doc/en/metadoc.xml
Created attachment 60255 [details, diff]
update for gentoo-security guide
This updates /doc/en/gentoo-security.xml
It is a simple message saying the guide has been deprecated in favor of the
Handbook and gives a link.
Created attachment 60256 [details, diff]
update uri in /security/en/index.xml
This patch updates the <uri> and changes the reference to handbook from guide.
Curtis, can you put it online on your site? Comment on attachment 60254 [details, diff]
update for metadoc.xml
Sorry, plenty of pointless changes but none of the required ones.
Comment on attachment 60255 [details, diff]
update for gentoo-security guide
A patch that removes all lines is not very useful, is it?
Comment on attachment 60256 [details, diff]
update uri in /security/en/index.xml
We can't change that one. Let's remember to ping its authors when we are ready.
Having a look. Did you change any content? In other words, are the sh-*xml files an exact break up of gentoo-security.xml? Please use xmllint to validate your files (<sections> may not have a <title> child) FYI, kernel-security had twice the same content. Note to translators: no content change. Looks good, but perhaps don't call the first (only) part of the handbook "Contents". Perhaps "System Security" with an abstract of "This part covers various system security aspects allowing you to harden your system on a step-by-step basis" or something similar? Created attachment 60364 [details] Security Handbook w/changes Sorry for not validating it first. It was on my list when I started. It was late when I attached it and I must have forgotten (I was a little overenthusiastic it seems). I did not change any content. I copied it directly with no content left out. I think I did a good job for my first Handbook :) Next time I'll make sure to get it right the first time. ___________ Validation complete. All pages now validate. Removed duplicate content from Kernel Security (not sure how I missed that). Changed the "Contents" to "System Security" as swift suggested. Added my name as an editor. Is this ok? attached new tarball with changes. -------------- View online: http://curtis119.no-ip.org/doc/en/security/ Don't bother. I've got all files ready and all needed some changes anyway (still no content changes). (In reply to comment #17) > Don't bother. I've got all files ready and all needed some changes anyway (still > no content changes). Great, thanks neysx! Were there any other mistakes besides the ones you already listed? I need as much feedback as possible so I don't make those same mistakes in the future. Thierry, CC'ed to you because you committed /security/en/index.xml recently. Can you update the link when you have a moment? Tx. "/doc/en/gentoo-security.xml" should become "/doc/en/security/" Note to translators: Please mind the cross-chapter links when splitting up gentoo-security.xml (see revisions 1.2 in http://www.gentoo.org/cgi-bin/viewcvs.cgi/en/security/?root=doc) (In reply to comment #19) > Can you update the link when you have a moment? Tx. > "/doc/en/gentoo-security.xml" should become "/doc/en/security/" Done. All done. Thanks a lot. |
