cvs commit: LFS/FAQ netiquette.xml faq.xml listofentries.ent

sklein at linuxfromscratch.org sklein at linuxfromscratch.org
Tue Jan 14 13:25:04 PST 2003


sklein      03/01/14 16:25:04

  Modified:    FAQ      faq.xml listofentries.ent
  Added:       FAQ      netiquette.xml
  Log:
  New netiquette entry. Reviews welcome. Some items still in comments.
  
  Revision  Changes    Path
  1.142     +1 -0      LFS/FAQ/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/FAQ/faq.xml,v
  retrieving revision 1.141
  retrieving revision 1.142
  diff -u -r1.141 -r1.142
  --- faq.xml	3 Jan 2003 04:00:47 -0000	1.141
  +++ faq.xml	14 Jan 2003 21:25:04 -0000	1.142
  @@ -34,6 +34,7 @@
   	&what-is-lfs;
   </qandadiv>
   <qandadiv id="how-to"><title>How-To</title>
  +	&netiquette;
   	&which-list;
   	&getting-help;
   	&contributing-to-faq;
  
  
  
  1.15      +1 -0      LFS/FAQ/listofentries.ent
  
  Index: listofentries.ent
  ===================================================================
  RCS file: /home/cvsroot/LFS/FAQ/listofentries.ent,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -r1.14 -r1.15
  --- listofentries.ent	3 Jan 2003 04:00:47 -0000	1.14
  +++ listofentries.ent	14 Jan 2003 21:25:04 -0000	1.15
  @@ -30,6 +30,7 @@
   <!ENTITY lilo-errors SYSTEM "lilo-errors.xml">
   <!ENTITY missing-x-includes SYSTEM "missing-x-includes.xml">
   <!ENTITY net-pf-x SYSTEM "net-pf-x.xml">
  +<!ENTITY netiquette SYSTEM "netiquette.xml">
   <!ENTITY new-version SYSTEM "new-version.xml">
   <!ENTITY nls-info SYSTEM "nls-info.xml">
   <!ENTITY no-dev-rtc SYSTEM "no-dev-rtc.xml">
  
  
  
  1.1                  LFS/FAQ/netiquette.xml
  
  Index: netiquette.xml
  ===================================================================
  <qandaentry id="netiquette">
  <question><para>What about netiquette?</para></question>
  <answer><para>Here are some completely practical points of etiquette.
  They include only those items that someone would comment on you for missing.
  </para>
  <para>For those who've been around project mailing lists awhile
  the first few items are an insult to the intellegence.
  There are better toward the end.
  </para>
  <para>The reasons for these are omitted for brevity,
  but rest assured, there are reasons
  and those reasons are more than just an individual's personal preferance.
  </para>
  <para>While the text refers to "the lists" exclusively,
  it doesn't intend to ignore the news groups
  to which the mailing lists are gatewayed.
  </para>
  <para>With that out of the way,
  here are a couple manners oriented items
  followed by more "mechanical" stuff.
  </para>
  <para>Please remember that it is rude to post answers
  that are answered in obviously available documentation
  such as the LFS and BLFS Books, this FAQ, the appropriate man pages,
  the list archives, and simple Google searches.
  As long as you can demonstrate that you've made an effort to find the answer
  and you're not offended by a pointer to documentation,
  no one should mind.
  Anyone who does mind can be ignored; they deserve it.
  </para>
  <para>Most of the bothersome flamewars start
  when a newbie with an overlarge ego posts an obvious question,
  is then laughed at (even in a kindly manner),
  and becomes publically offended.
  Please try to avoid this situation.
  Even the most unintellegent newbies (there are intellegent newbies)
  will usually realise their error,
  even if you don't mention that they're not being bright,
  if you point them at the exact documentation they should have read
  </para>
  <para>As everywhere, things which are likely to become heated
  are best done off the lists, involving as few people as possible.
  </para>
  <para>Now for the more "mechanical" stuff.
  </para>
  <para>Do not post in HTML.
  If you use Yahoo, Hotmail, or Outlook
  and haven't turned HTML off, then it is on.
  If you're using another mail client, please do check before posting.
  If you don't know how to turn HTML off,
  see <ulink url="http://www.expita.com/nomime.html"/>.
  </para>
  <para>Wrap text at 72 characters.
  If you do not wish to do this by hand,
  set your mail client to do it automatically when sending.
  </para>
  <para>Reply below quoted text.
  <!-- XXX: A well formatted example is below. -->
  Outlook makes this difficult.
  There is a plugin to fix Outlook at
  <ulink url="http://home.in.tum.de/~jain/software/outlook-quotefix/"/>,
  and one for Outlook Express at
  <ulink url="http://home.in.tum.de/~jain/software/oe-quotefix/"/>.
  </para>
  <para>Do not click reply unless you're actually replying to a post.
  Use new or compose or whatever your mail client calls it.
  Reply sets more than just the subject line
  and will cause your post to appear in the wrong place
  unless you're actually answering.
  </para>
  <para>This isn't major, but is useful to know.
  On the LFS lists, people usually clear the CC field
  and just mail the list with replies.
  This is probably not a good idea but is existing practice
  due to a political situation which is unlikely to change.
  </para>
  <!-- XXX: future stuff
  
  Trim quoted text, especially signatures.
  But don't trim so much as to make it confusing to read your reply
  without consulting the original.
  
  Be careful to use the correct list.
  
  In general, do not reply to spam on the list.
  If you do find a valid reason to reply,
  definitely do not quote all of it in your reply.
  
  If a thread drifts into general topics,
  move it to lfs-chat.
  
  Remember, every post will be read by more than 500 people.
  
  Don't cross-post.
  Many people are subscribed to more than one list
  and will just be annoyed to see your post twice.
  
  fix this example to include a couple three messages and some code
  
  Joe <joe at joe.org> wrote:
  > Jane <jane at jane.org> wrote:
  > > Joe <joe at joe.org> wrote:
  > > > 
  > > > Hi Jane, did you see the new release of the fireworks plugin?
  > > > It is much faster on x86 machines because someone wrote assembly
  > > > routines for the worst spots.
  > > 
  > > No, i didn't see the new fireworks plugin release. Thanks for
  > > alerting me Joe.
  > > 
  > > It's nice they're working on the speed. So sad that assembly
  > > won't work on my laptop :( Maybe i'll find time to work on PPC
  > > assembly for it next week.
  > 
  > If you do work on PPC assembly for the fireworks plugin, i'd be
  > delighted to help.
  
  Hey, that's great! I've attached a couple routines. They're rough
  but i already notice a 10% speedup over the C code. Let me know what
  you think.
  
  Jane
  - - 
  Jane Doe, Flower Pot Graphics Design   http://www.flowerpotgraphics.com/
  
  
  Of particular note is the signature which is separated by "- - ",
  that's dash-dash-space on a line by themselves
  (and is difficult to express in xml)
  and is short. Less than four lines.
  
  If you actually want to be read and understood
  in a high traffic place like the LFS lists,
  paragraph separation, use of lists, and general whitespace use
  are surprisingly critical.
  
  
  -->
  </answer>
  </qandaentry>
  
  
  
-- 
Unsubscribe: send email to listar at linuxfromscratch.org
and put 'unsubscribe lfs-book' in the subject header of the message



More information about the lfs-book mailing list