On Wednesday 27 April 2005 12:14, rich foo wrote: > John, > > I certainly didn't mean to sound as though I was bashing the > documentation, I am only bashing myself for not being able to figure out > what I am doing wrong. The only reason I stressed that my config was > straight from the documentation was to provide a clearer picture of my > setup, and to point out that I was taking your advice and trying to work > through the examples given. > > I have started again from scratch with samba-3.0.15pre2 and I will send > you your requested config files shortly. > > Thanks, and again, I certainly did not mean to bash the documentation. I > fully realize that a lot of work goes into it and I am grateful for samba > and all it has done for me over the past 10 years since my first install.
Rich, I am not emotionally attached to the documentation, but I do want to get it right. The current documentation update provides numerous checks and balances against common typographic mistakes. Whereever it makes sense in the current documentation update I am adding checks and validation steps to weed-out commonly made mistakes. My approach to the documentation has been shaped by feedback from this list. I know the documentation is mostly correct - we have had enough feedback that it works that I am not in doubt about the documentation. That said, if anyone can justly claim to have followed the documentation, and it did not work, then as far as I am concerned the documentation has failed! No questions - it failed. The documentor's challenge is to write in such a way that every step is designed to catch errors. That means that any error that you make in following the documentation IS my problem. PS: Since Samba is open source, user contributed software, that by definition means that this is a community problem also. In other words, if you allow me to get away with buggy documentation that is your fault as a user, as much as it is my fault as the writer. So, blast away please. Let's get it right! Please give me all the criticism of the documentation you can think of. I want it all and I want it full-on. - John T. > > Rich > > > Rich, > > > Instead of assuming the examples in the book are wrong, or do not work, > just > because you can not get them to work, may I suggest that you work with me > to > "fix" the documentation so others can avoid your pain. > > > Please send me direct to <[EMAIL PROTECTED]> the following: -- John H Terpstra Samba-Team Member Phone: +1 (650) 580-8668 Author: The Official Samba-3 HOWTO & Reference Guide, ISBN: 0131453556 Samba-3 by Example, ISBN: 0131472216 Hardening Linux, ISBN: 0072254971 Other books in production. -- To unsubscribe from this list go to the following URL and read the instructions: https://lists.samba.org/mailman/listinfo/samba
