docs: insert meta data into socket options parameter
[Samba/wip.git] / docs-xml / Samba3-HOWTO / TOSHARG-foreword-cargill.xml
blobb5da92d5b7ee6560d9f443beb2a1638861a37dbd
1 <?xml version='1.0'?>
2 <!DOCTYPE preface PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
3 <preface>
4 <title>Foreword</title>
6 <para>
7 When John first asked me to write an introductory piece for his latest book, I was somewhat mystified as to
8 why he chose me. A conversation with John provided some of the rationale, and he left it to me to fill in the
9 <emphasis>rest</emphasis> of the story. So, if you are willing to endure a little bit of background, I will
10 provide the part of the story that John wouldn't provide.
11 </para>
13 <para>
14 I am the Director of Corporate Standards at Sun Microsystems, and manage Sun's standards portfolio. Before
15 that, I was the Director of Standards at Netscape, which was when I met John. Before Sun, there was Digital
16 Equipment Corporation, also standards. I've written several books on standards, and tend to observe (and
17 occasionally help) the technical and business trends that drive standardization as a discipline. I tend to see
18 standardization as a management tool, not as a technical discipline and this is part of the rationale that
19 John provided.
20 </para>
22 <para>
23 The book that you have before you focuses on a particular standardized way of doing something hence, it is a
24 book about a standard. The most important thing to keep in mind about a standard is the rationale for its
25 creation. Standards are created not for technical reasons, not for business reasons, but for a deeper and much
26 more compelling reason. Standards are created and used to allow people to communicate in a meaningful way.
27 Every standard, if it is a true standard, has as its entire (and only) goal set the increasing of relevant
28 communication between people.
29 </para>
31 <para>
32 This primary goal cannot be met however, unless the standard is documented. I have been involved in too many
33 standardization efforts when it became apparent that <emphasis>everybody knows</emphasis> was the dominant
34 emotion of those providing documentation. <emphasis>They</emphasis> of the ever present <emphasis>they
35 say</emphasis> and <emphasis>they know</emphasis> are the bane of good standards. If <emphasis>they
36 know</emphasis>, why are you doing a standard?
37 </para>
39 <para>
40 A <emphasis>good standard</emphasis> survives because people know how to use it. People know how to use a
41 standard when it is so transparent, so obvious, and so easy that it becomes invisible. And a standard becomes
42 invisible only when the documentation describing how to deploy it is clear, unambiguous, and correct. These
43 three elements must be present for a standard to be useful, allowing communication and interaction between two
44 separate and distinct entities to occur without obvious effort. As you read this book, look for the evidence
45 of these three characteristics and notice how they are seamlessly woven into John's text. Clarity and
46 unambiguity without <emphasis>correctness</emphasis> provide a technical nightmare. Correctness and clarity
47 with ambiguity create <emphasis>maybe bits,</emphasis> and correctness and unambiguity without clarity provide
48 a <emphasis>muddle through</emphasis> scenario.
49 </para>
51 <para>
52 And this is <emphasis>the rest of the story</emphasis> that John couldn't (or wouldn't) bring himself to
53 state. This book provides a clear, concise, unambiguous, and technically valid presentation of Samba to make
54 it useful to a user to someone who wants to use the standard to increase communication and the capability
55 for communication between two or more entities whether person-machine, machine-machine, or person-person.
56 The intent of this book is not to convince anyone of any agenda political, technical, or social. The intent
57 is to provide documentation for users who need to know about Samba, how to use it, and how to get on with
58 their primary responsibilities. While there is pride on John's part because of the tremendous success of
59 the Samba documentation, he writes for the person who needs a tool to accomplish a particular job, and who has
60 selected Samba to be that tool.
61 </para>
63 <para>
64 The book is a monument to John's perseverance and dedication to Samba and in my opinion to the goal of
65 standardization. By writing this book, John has provided the users of Samba those that want to deploy it to
66 make things better a clear, easy, and ultimately valuable resource. Additionally, he has increased the
67 understanding and utility of a highly useful standard, and for this, as much as for the documentation, he is
68 owed a debt of gratitude by those of us who rely on standards to make our lives more manageable.
69 </para>
71 <para>
72 <simplelist>
73         <member>Carl Cargill, Senior Director</member>
74         <member>Corporate Standardization, The Office of the CTO</member>
75         <member>Sun Microsystems</member>
76 </simplelist>
77 </para>
78         
79 </preface>