OpenSUSE mailinglijst-netiquette

Deze netiquette is een aanbeveling over het schrijven van berichten naar de openSUSE mailinglijsten die gemakkelijk te lezen zijn, de hoeveelheid tekst en het aantal berichten verminderen, helpen elkaar te verstaan en flames vermijden. Als u naar deze pagina verwezen bent na het posten van een bericht dan is de reden waarschijnlijk dat u iets verkeerds deed/schreef, zoals we dat allemaal wel eens doen, voelt u zich dan niet alleen en lees verder. Dat helpt ons allemaal, de gebruikers van de openSUSE mailinglijsten.

Waarom we netiquette nodig hebben

Oude rotten en echte specialisten, diegenen die een goed advies kunnen geven, lezen erg veel e-mail per dag en hebben geen tijd om berichten te ordenen alvorens deze te lezen. Dus als u snel een goed advies wilt, pas dan de stijl van posten aan aan de gewoonten van de openSUSE mailinglijsten. Al wat er gevraagd wordt is gewoon beleefdheid, op dezelfde manier als wanneer u bij een groep wilt aansluiten die al omgangsregels hebben vastgesteld. U kunt niet verwachten dat de hele groep zich aan u aanpast, integendeel.

Hieronder staat een verzameling van onze gewoonten en de reden waarom wij deze toepasselijk vinden. Als u in nood bent dan begrijpen wij dat wel. U kunt de netiquette lezen nadat u uw eerste vraag hebt gepost.

Doe het zelf

Het eerste wat u doet alvorens een e-mail naar de lijst te schrijven, is om zelf een oplossing te vinden. Dat is sneller, u kunt iets leren en het minimaliseert het verkeer. Als u een vraag hebt over een programma, lees dan eerst de manpages (man programmanaam) van het programma. Ook kunt u zoeken in /usr/share/doc/packages en /usr/share/doc/howto voor oplossingen.

U hebt natuurlijk eerst de openSUSE handleidingen gelezen. Deze zijn beschikbaar op de openSUSE cd's.

U kunt ook de openSUSE-Support Database raadplegen voor informatie. The SDB's zijn beschikbaar op http://en.opensuse.org/SDB:History. Deze database is werk in uitvoering. Het wordt vernieuwd.

De site http://www.tuxsucht.de is een speciale aangepaste Google Zoeken en deze zoekt naar Linux gerelateerde zaken.

Nog een optie u kunt naar onze officiële ondersteuningsforums gaan:

• http://forums.opensuse.org

U kunt Usenet gebruiken voor informatie door http://groups.google.com te gebruiken. Misschien heeft iemand uw vraag al beantwoord in het verleden. Tenslotte, maar niet als minste, kunt u in het archief van de mailinglijst zoeken. In het archief vindt u de e-mails vanaf 2000. Beter eerst zoeken alvorens voor de 17de keer dezelfde vraag te stellen. U vindt de archieven in:

• http://lists.opensuse.org

Daar kunt u lezen en surfen door het archief.

Een ander archief voor andere mailinglijsten over Linux kunt u daar vinden: http://www.marc.theaimsgroup.com/.

Gebruik een beschrijvend onderwerp

De openSUSE mailinglijst ontvangt honderden e-mails per dag. Dus als u een vraag hebt of een probleem op wilt lossen, gebruik dan het onderwerp om uw kwestie samen te vatten en om een enkel detail uit uw bericht aan te geven. Onderstaand enige voorbeelden van onderwerpen uit echte berichten op de opensuse mailinglijst (in het Engels, want dat is de voertaal):

Nog meer over slechte onderwerpen:

• [1] Hulp geschreven door de Linux-veteranen Eric Raymond en Rick Moen] voor computergebruikers met een probleem en nog niet weten hoe de juiste vraag te stellen om een direct antwoord te krijgen.

Als uw probleem is opgelost, dan gaarne Het Onderwerp als opgelost (solved) markeren. Een voorbeeld:

Subject: My great Subject (solved)

Op die manier kunnen we zien dat het onderwerp is gesloten.

E-mailopmaak

U zou regelafbreking op 72 tekens moeten zetten in uw E-mailprogramma. U kunt deze vinden in de Voorkeuren.

Aanhalen

Als u op een bericht antwoord geeft dan is het beter alleen de relevante delen aan te halen (te laten staan). U behoeft alleen die paar woorden, die belangrijk zijn en waarop u reageert, te laten staan. Iedereen op een mailinglijst wordt bediend door één server voor die lijst en ontvangt snel alle berichten. Dit betekent dat het niet nodig is het gehele bericht nog eens in zijn geheel te posten, zoals in Usenet (nieuwsgroepen) waar het mogelijk is dat u het antwoord ziet vele uren eerder dan de vraag.

• The quoting HOWTO (Hoe aan te halen) geeft in het Engels een mooie introductie in de kunst van het aanhalen in e-mail.

Onder(aan) of tussendoor stijl van antwoorden

Gemeenschappelijk aan beiden is dat u relevante zinnen aanhaalt uit het voorgaande bericht en antwoordt onder de aanhaling. Dit zijn de stijlen voor gebruikt in mailinglijsten, eerst de vraag (aanhaling) dan het antwoord.

Onder(aan) antwoorden (Bottom post)

Bottom post (onder(aan) antwoorden) is de stijl die u gebruikt bij een antwoord op een enkele vraag of na een enkele bewering.

Het betekent dat u uw reactie onder de aangehaalde tekst zet. Dit leidt tot een natuurlijke volgorde in berichten met aangehaalde delen uit vorige antwoorden.

Tussendoor stijl

De tussendoor stijl wordt gebruikt bij een aantal vragen of beweringen in een voorgaand bericht. Op die manier ziet de lezer eerst de bewering/vraag en dan het antwoord.

Waarom hebben we voorkeur voor deze twee stijlen

De discussieonderwerpen bevatten opmerkingen over:

• uitvoer van een commando, configuratie-bestanden of programmacode die vaak meer dan één regel bevat en verschillende commentaren verweven met de oorspronkelijke tekst
• groepen van uitgevoerde tests om een probleem te analyseren,

hierbij hebben we een stijl nodig die toestaat ingevoegd commentaar in aanhalingen van het oorspronkelijke bericht met ruimte voor een samenvatting of een volgend voorstel aan het eind van het bericht.

Het is een feit dat we in verschillende tijdzones leven, dus één optie geven en dan een dag wachten op het antwoord en daarna een volgend voorstel, zou tijdverlies opleveren. De discussie zou zich over verschillende dagen uitstrekken. Daarom proberen we dat te vermijden door meer opties ineens te geven met antwoorden die verweven zijn met de oorspronkelijke voorstellen.

De tijd en de praktijk heeft de consensus doen ontstaan dat dit een betere manier van communiceren is op lijsten. Lijsten kunnen echter verschillende operationele condities hebben en kunnen een andere stijl van posten als beter toepasbaar hebben.

Changing the subject without opening a new thread

Very often a long thread splits into several topics (for example if there are several answers to the same problem). In this case changing the subject may be necessary. One widely accepted method for this is a subject like

Re: kde icon blinks (was: is that an Xfree problem?)

Later reply posts usually remove the (was: ...) part. This allows to change a subject, but keep thread structure intact. If the discussion led to a totally different subject, you may stop, open a new thread and go on. On the other side usually others wont follow you and still discuss in old thread, so use thread splitting wisely.

Also, do not simply hit Reply to a message and change the subject to start a new discussion. When you do so you break the thread that was in progress making it hard to follow in the archives.

Don't be aggressive

This applies to new and old openSUSE mail list users. Most of the people on the list are friendly and helpful people. They use their free time to help others so even if you are angry because you can't solve some problem, please, calm down and then post your question. It will help you to tell what is the problem without aggressive and abusive language, and it will help readers to understand what is the problem.

To answer the question one has to know a few details about the problem. Don't be upset because there is a question asking for more information. We would like to help, but not everybody has a good [http:/en.wikipedia.org/wiki/crystal_ball|crystal ball] to see the things that are not written in email, so we have to ask.

Understand that the audience is passionate about openSUSE, posting that you hate openSUSE, Linux, the mailing list, or other closely related things, will most likely get passionate responses, don't take things too personally.

Mail lists are used by a lot of people who's first language is not English, nor do they know computer related terms. This sometimes leads to misunderstandings in excess of the normal misunderstandings that can happen in email exchanges.

Don't be aggressive to new posters, but instead help them on their way to become a part of our community, sometimes a private email may be appropriate, to explain something, but mainly it is not wanted and if it has answer it is interesting not only for poster, but also for many that read the list archives, for instance after looking for answer on Google.

Personal attacks are not wanted on any openSUSE mail list..

Personal and mail list answers

Replies to the posts (emails) that you receive through the mail list should go to back to the list so that others searching the archives at a later date can benefit. In case when your reply is not related to the thread use direct mail.

Although, some people don't like it when they receive a reply to a list post direct to their email address, other don't mind (that much). Sometimes people explicitly indicate that they don't want to receive mails direct to their email address and not via the list. To be on safe side, it is better to avoid direct replies without invitation.

There is also a problem with some mail programs that don't have the option "Reply to List". You can use "Reply to All" and then remove all except the opensuse.org address. See example below, how it should appear. Remember that for one to post to the list assumes that he reads the list, therefore a direct mail in addition to the list post is a duplicate on an already voluminous list.

How to know where answer will go? It is easy, there is address field at the top of your mail program. You can see in example what you should look for:

Don't use a long signature block

Most people on the list genuinely want to help people out in solving any issues they may have. Very large signature blocks at the bottom of emails can hinder this as they often swamp the actual body of the email. Reference on your system properties, address, web page, etc, has just opposite effect than you may want if it is too long.

A good guideline is a maximum of four lines with not more than 80 characters of plain text.

For reference read Jargon File: McQuary Limit

Attachements

If its needed, to post a Logfile or similar to that, please don't use the Mail for that. Better use an Pasteserver like http://en.pastebin.ca for that. If its needed to post Pictures, so use from 500Kb One-Klick-Hoster like Rapidshare.

Don't post Off Topic emails to the mail lists

Each list is created to discuss one part of the openSUSE activity. The topic is posted on Communicate/Mailinglists page next right to the links for subscription and help. Please stay within this realm and help reduce the volume of unrelated posts to any list.

It may seem interesting to discuss topics not related to openSUSE as listed on Communicate/Mailinglists page and for that purpose is created opensuse-offtopic@opensuse.org list, so be kind and use it for any topic you like.
P.S.
It has to be off topic otherwise it is off topic for this list :-)
Use common sense when posting article, it is openSUSE list, not misc-current-politics. Not every topic is wanted.

Do not use HTML

Most of openSUSE mail lists users have HTML turned off for many reasons (1). HTML message looks strange as a plain text and it is hard to read. People will avoid it if possible, or complain asking you to post in plain text if they can't skip it.

(1)Believe it or not there are still many people who are forced to use metered dialup connections to the internet and posting to the list using html adds considerably to their costs. So please show consideration to _all_ list members and post using plain text email only. (2) Some properties of HTML are misused by spammers to harvest email addresses and good email client programs are set not to use HTML, except by user request. That makes HTML post unreadable and people just skip them.

Conclusion

This is how we make our lives easier while being as effective in helping others as time permits.

We don't mind occasional posts that don't lean to netiquette, specially if someone is in hurry, new to our mail list, using mobile device that lacks functions, but permanently breaking rules will not make you any friends.

If you find ideas expressed here to be too restrictive, or lacking some important information, feel free to comment using Discussion link at the top of the page.

Feedback you can send to: Sascha Manns

See also

• Mail is list of few articles about email
• Mail Clients is list of few mail programs used to read email

[more to do]