Table of Contents

Communication Guidelines

These guidelines are intended for # VIKINGS staff. Your communication style may differ from these guidelines, and that is fine! However, as ambassadors of our association, we ask that you apply the following guidelines. We invite everyone, especially those associated with us, to contribute comments to help improve these guidelines.

Apply the robustness principle / Postel's law

> Be conservative in what you do, be liberal in what you accept from others.

See also:

Email

Formatting

Use plain text email

A properly written and formatted plain text email works much better across devices and systems. Use plain text at all times.

Text mail formatting

Text-based email should not exceed 80 columns per line of text. Consult the documentation of your email client to enable proper line breaks around column 78.

Do not use HTML email

HTML email - even when it is a multipart mail with a corresponding plain/text section - is often unconditionally rejected by mailing lists. The plain/text section of multipart HTML email is generated by email clients and often results in unreadable gunk.

Do not use multipart email

Again, use plain/text email and not some “magic” format. When sending patches via email refrain from attaching patches as that makes it impossible to reply to the patch directly.

General hygiene and etiquette

this section should probably apply to all communication

You don't want your emails to have bad breath, do you?

TL;DR: use common-sense.

Email signatures

Use the standard email signature provided to you.

You shall not add additional text (confidentiality disclaimers (why would you!?), funny quotes, slogans, MOTD's, ASCII art etc.) to your signature, unless this has been signed off by someone responsible for the guidelines.

Please do not remove (parts of) the signature; certain content is required by law in our current jurisdiction, often for each and every email that leaves our internal systems, so it's better to be safe than sorry. This may be annoying (to you *and* the recipient) and counterintuitive at times, as some laws can be. Relying on the template provided to you will ensure that these legal requirements are met at all times.

Carbon copies (Cc)

Trimming Cc lists is considered a bad practice. Replying only to the sender of an email immediately excludes all other people previously involved and defeats the purpose by turning a public discussion into a private conversation.

Top-posting

If you reply to an email do not top-post. It is considered bad form. It also is evil and every time you do that, a cute little kitten dies. It may be the preferred style in most corporate environments, but that does not excuse it as these examples show:

A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing in email?
A: No.
Q: Should I include quotations after my reply?

Of course, you can and sometimes should add your own comments at the beginning of the text as a preface and continue inline below.

See also: http://daringfireball.net/2007/07/on_top

Trim replies

When you reply to an email, trim unneeded content from the email you're replying to. Quoting an entire message is as bad a style as top posting.

Different rules?

If you participate in an external mailing list or similar, please apply the rules applicable there which may differ in detail from our guidelines outlined here.

IRC & other text-based chat systems

ToDo FIXME

Phone

ToDo FIXME

Branding

ToDo FIXME