Jamie Nguyen
dysco****@gmail*****
Wed Feb 9 07:45:10 JST 2011
So I am now very nearly finished with writing 1.8 documentation. Hopefully in the next couple of days it will all be done. I need to write chapter-12.html.en which will be on judging execute request outside of the kernel and use of the execute handlers and audit-exec-param. And chapter-3.html.en only has place holders and must be replaced with real installation instructions. When all is done I will do a final proof read for typos. The docs related to android/cat760/meego/sftp/ssh-protection/ssh-recording/ssh-split I have merely restyled. I have no plans to change any of the core text. I also worked through tool-editpolicy.html.en and made it shorter, removing some pictures. Feel free to add back any pictures you want if you think I have removed too much. 1) Could you please briefly check through the contents of htdocs/1.8-tmp and let me know if there is any major changes you want me to make, or whether there is something missing etc. ? 2) Also, I have implemented 1.8-tmp/tutorial-{15,16}.html.en in docs. However, the "About keep_domain keyword" section of tutorial-17.html.en seems to be a verbose explanation of how to limit memory usage. I think I can insert a shorter version in 1.8-tmp/chapter-5.html.en#5.5 (or create chapter-5.html.en#5.6). The "About execute handler mechanism" section of tutorial-17.html.en I will place in chapter-12.html.en that I mentioned above. Thus, the content that is left in tutorial-17 is the information about difference between 1.7 and 1.8...I personally think this is more relevant for release notes, but not in documentation so I will not include. Do you have any objections? 3) Do you feel that we need to place verbose instructions in the chapter-3.html.en about GRUB? I might just add a small note saying something like "consult distro and bootloader docs for information". Every distribution seems to use different method to update grub, different default grub settings and different grub version etc. we would have to have several distro specific instructions. Personally, I think it is duplication of information as there are already several places you can find out how to change grub entries and how to manage grub. Also the user may be using syslinux or other bootloader. I'm open to suggestion and don't really mind either way, but I think if they have ventured out to use 1.8 instead of 2.3, they probably already know how to use grub, and if they don't then it's easy enough to find out how. Kind regards