mtab a real file now
[linux_from_scratch.git] / FAQ-OBSOLETE / netiquette.xml
blobc89edcf19f6712920cf099625804a70ea1eeb169
1 <qandaentry id="netiquette">
2 <question><para>What about netiquette?</para></question>
3 <answer><para>Here are some completely practical points of etiquette.
4 They include only those items that someone would comment on you for missing.
5 </para>
6 <para>For those who've been around project mailing lists awhile
7 the first few items are an insult to the intellegence.
8 There are better toward the end.
9 </para>
10 <para>The reasons for these are omitted for brevity,
11 but rest assured, there are reasons
12 and those reasons are more than just an individual's personal preferance.
13 </para>
14 <para>While the text refers to "the lists" exclusively,
15 it doesn't intend to ignore the news groups
16 to which the mailing lists are gatewayed.
17 </para>
18 <para>With that out of the way,
19 here are a couple manners oriented items
20 followed by more "mechanical" stuff.
21 </para>
22 <para>Please remember that it is rude to post questions
23 that are answered in obviously available documentation
24 such as the LFS and BLFS Books, this FAQ, the appropriate man pages,
25 the list archives, and simple Google searches.
26 As long as you can demonstrate that you've made an effort to find the answer
27 and you're not offended by a pointer to documentation,
28 no one should mind.
29 Anyone who does mind can be ignored; they deserve it.
30 </para>
31 <para>Most of the bothersome flamewars start
32 when a newbie with an overlarge ego posts an obvious question,
33 is then laughed at (even in a kindly manner),
34 and becomes publically offended.
35 Please try to avoid this situation.
36 Even the most unintellegent newbies (there are intellegent newbies)
37 will usually realise their error,
38 even if you don't mention that they're not being bright,
39 if you point them at the exact documentation they should have read
40 </para>
41 <para>As everywhere, things which are likely to become heated
42 are best done off the lists, involving as few people as possible.
43 </para>
44 <para>Now for the more "mechanical" stuff.
45 </para>
46 <para>Do not post in HTML.
47 If you use Yahoo, Hotmail, or Outlook
48 and haven't turned HTML off, then it is on.
49 If you're using another mail client, please do check before posting.
50 If you don't know how to turn HTML off,
51 see <ulink url="http://www.expita.com/nomime.html"/>.
52 </para>
53 <para>Wrap text at 72 characters.
54 If you do not wish to do this by hand,
55 set your mail client to do it automatically when sending.
56 </para>
57 <para>Reply below quoted text.
58 <!-- XXX: A well formatted example is below. -->
59 Outlook makes this difficult.
60 There is a plugin to fix Outlook at
61 <ulink url="http://home.in.tum.de/~jain/software/outlook-quotefix/"/>,
62 and one for Outlook Express at
63 <ulink url="http://home.in.tum.de/~jain/software/oe-quotefix/"/>.
64 </para>
65 <para>Do not click reply unless you're actually replying to a post.
66 Use new or compose or whatever your mail client calls it.
67 Reply sets more than just the subject line
68 and will cause your post to appear in the wrong place
69 unless you're actually answering.
70 </para>
71 <para>This isn't major, but is useful to know.
72 On the LFS lists, people usually clear the CC field
73 and just mail the list with replies.
74 This is probably not a good idea but is existing practice
75 due to a political situation which is unlikely to change.
76 </para>
77 <!-- XXX: future stuff
79 Trim quoted text, especially signatures.
80 But don't trim so much as to make it confusing to read your reply
81 without consulting the original.
83 Be careful to use the correct list.
85 In general, do not reply to spam on the list.
86 If you do find a valid reason to reply,
87 definitely do not quote all of it in your reply.
89 If a thread drifts into general topics,
90 move it to lfs-chat.
92 Remember, every post will be read by more than 500 people.
94 Don't cross-post.
95 Many people are subscribed to more than one list
96 and will just be annoyed to see your post twice.
98 fix this example to include a couple three messages and some code
100 Joe <joe@joe.org> wrote:
101 > Jane <jane@jane.org> wrote:
102 > > Joe <joe@joe.org> wrote:
103 > > > 
104 > > > Hi Jane, did you see the new release of the fireworks plugin?
105 > > > It is much faster on x86 machines because someone wrote assembly
106 > > > routines for the worst spots.
107 > > 
108 > > No, i didn't see the new fireworks plugin release. Thanks for
109 > > alerting me Joe.
110 > > 
111 > > It's nice they're working on the speed. So sad that assembly
112 > > won't work on my laptop :( Maybe i'll find time to work on PPC
113 > > assembly for it next week.
115 > If you do work on PPC assembly for the fireworks plugin, i'd be
116 > delighted to help.
118 Hey, that's great! I've attached a couple routines. They're rough
119 but i already notice a 10% speedup over the C code. Let me know what
120 you think.
122 Jane
123 - - 
124 Jane Doe, Flower Pot Graphics Design   http://www.flowerpotgraphics.com/
127 Of particular note is the signature which is separated by "- - ",
128 that's dash-dash-space on a line by themselves
129 (and is difficult to express in xml)
130 and is short. Less than four lines.
132 If you actually want to be read and understood
133 in a high traffic place like the LFS lists,
134 paragraph separation, use of lists, and general whitespace use
135 are surprisingly critical.
139 </answer>
140 </qandaentry>