Difference between revisions of "Mailing List etiquette"

From MythTV Official Wiki
Jump to: navigation, search
m (Anything else I should be aware of?: formatting and clarification)
(What have you done?: we need to see *the right* log info to figure out what's wrong (and, why limit my being rude to only on the list, when I can rudely ask for the right log info here, too))
(45 intermediate revisions by 16 users not shown)
Line 3: Line 3:
 
===Posting Style===
 
===Posting Style===
 
====Post in plain text====
 
====Post in plain text====
* This reduces the load that the mail server has to cope with when sending your message on to the thousands of subscribers.
+
* Plain text messages are significantly smaller in size and can dramatically reduce mail server load when sending your message to thousands of subscribers.
* The reduced message size helps people on dial-up connections.
+
* Reduced message size helps people on dial-up connections or with limited email quotas.
 
* Plain text can be interpreted by '''''all''''' mail clients.
 
* Plain text can be interpreted by '''''all''''' mail clients.
* I don't care what font, font size, or color ''you'' like.
+
* Plain text rendering is consistent within a user's mail client. I don't care what font, font size, or color ''you'' like.
 +
* Plain text is easier to prune in responses than html text.
 +
If you are using [http://email.about.com/od/outlooktips/qt/et010406.htm Outlook] or Outlook Express you can add the address of the mailing list to your address book and then enable to option to "send messages in plain text to this recipient". Here's [http://helpdesk.rootsweb.com/listadmins/plaintext.html some information] on configuring these and other clients & web-mail gateways to send in plain text.
  
 
====Bottom post====
 
====Bottom post====
* Bottom posting means adding your reply to the bottom of the previous message.  This is easily achieved in '''''all''''' mail clients by pressing [Ctrl] and [End] before doing any other typing.<br>The reason for this is best summed up in the following piece of text which one of the list members uses as his sig:<br>A: Because it messes up the order in which people normally read text.<br>Q: Why is top-posting such a bad thing?<br>A: Top-posting.<br>Q: What is the most annoying thing on usenet and in e-mail?
+
* Bottom posting means adding your reply to the bottom of the previous message.  This is easily achieved in most mail clients by pressing [Ctrl] and [End] before doing any other typing.
 +
* The reason for bottom posting is best summed up in the following piece of text (hint, try reading it first from the top to the bottom, then try reading it from the bottom to the top):<br>A: Because it messes up the order in which people normally read text.<br>Q: Why is top-posting such a bad thing?<br>A: Top-posting.<br>Q: What is the most annoying thing on usenet and in e-mail?
 +
 
 +
* Bottom posting works best with the MythTV-users list because it allows for easier reading of individual messages by making it possible to follow exactly what the conversation is about and where it currently is without having to dig back through previous messages or drill down through the current message.  Top posting is typically and more efficiently used in one-to-one email communications rather than on a mailing list.
 
* An acceptable alternative to bottom posting is interleaving your responses with the previous message.  This can help the flow of a message if the subject matter is complicated.  If you do this, make sure that the previous message has each line prefixed with '>' or similar to denote that it is not your writing.
 
* An acceptable alternative to bottom posting is interleaving your responses with the previous message.  This can help the flow of a message if the subject matter is complicated.  If you do this, make sure that the previous message has each line prefixed with '>' or similar to denote that it is not your writing.
 
** An optional method for formatting interleaved posts for easier reading is to leave 1 blank line between your text and what your responding to and two blank lines after your text and the next section of quoted text.
 
** An optional method for formatting interleaved posts for easier reading is to leave 1 blank line between your text and what your responding to and two blank lines after your text and the next section of quoted text.
  
 
====Trim your message====
 
====Trim your message====
* Always remove the unneeded parts of the previous message.  This always includes the footer and signature from the previous message.
+
* Always remove any unneeded parts of the previous message or thread.  This always includes the footer and signature from the previous message.
 
* If the previous message is long and complicated and you are replying to only one part, only include that part in your reply.
 
* If the previous message is long and complicated and you are replying to only one part, only include that part in your reply.
 +
* Less is more.  Don't be fearful of deleting some content from the original posting or previous responses.
  
 
===Message Content===
 
===Message Content===
 
* Keep the Language Simple
 
* Keep the Language Simple
** Not all list subscribers have English as their first language. Keeping it simple gives everyone a fighting chance of understanding what you're on about.
+
** Don't assume that list subscribers are native English speakers. Keep your message simple so that we all understand you.
** The simpler your message the easier it is for people to read.  The more difficult it is to read your message, the less likely that someone is going to take the time to give you an answer.
+
** Simpler messages are easier to read.  Messages that are difficult to read or understand will get fewer and less helpful responses.
 +
* Don't over-simplify
 +
** As a poster, do not assume that a majority of the people out there are running the exact same hardware, with the exact same configuration, or with the exact same issue(s) that you are experiencing.  Try to be descriptive to the point of informative.  A simple "It doesn't work" message will not generate the response you are looking for.
 +
** As a responder, do not assume that the individual you are responding to is as savvy or more savvy than yourself.  Remember, you are not necessarily '''just''' responding to the original poster, you are responding to everyone else on the list.  You might be helping out a lot more people that you think you are.
  
 
==MythTV-users specific etiquette==
 
==MythTV-users specific etiquette==
* Please don't cross post
+
===Stay on point / Stay on Topic===
** Posts shouldn't be sent to both -dev and -users listsIf you're not sure which list is appropriate, start with -users until you're asked to move it to -dev.
+
* This is the MythTV users mailing list, after all.  It is generally frowned upon to ask questions regarding items unrelated to MythTV (eg: "How do I build a computer?", "How to install MySQL", etc).  However, keep in mind that there are questions that are not '''directly''' related to MythTV but '''are''' related to your specific setup of MythTV.  Some list members may frown on such messages on the mailing list, but, again, this is the '''users''' mailing list and, as such, they are acceptable.  Please use some form of judgement when posting off topic questions or messages to the list.
 +
* If a conversation drifts so far away from the original topic, '''start a new thread'''.  Nothing is worse than following a thread only to see that the message titled "problems with lirc" only contains information about various IR receivers, cases, and power suppliesThis is most noticable when you are performing searches in the archives of the list and you are the one looking for a particular solution: you're forced to wade through many (in some cases, dozens) of off topic emails to find the email containing the solution you are looking for.
  
* Have you searched the mailing list archive?
+
===Please don't cross post===
** The archive can be found at http://www.gossamer-threads.com/lists/mythtv/users/
+
* Posts shouldn't be sent to both -dev and -users lists. If you're not sure which list is appropriate, start with -users until you're asked to move it to -dev.
** To search it using Google, use this 'site:www.gossamer-threads.com/lists/mythtv/users/' as part of your [http://www.google.com/search?hl=en&q=site%3Awww.gossamer-threads.com%2Flists%2Fmythtv%2Fusers%2F&btnG=Google+Search&meta= Google search]
 
  
* Which version of Myth are you using?
+
===Have you searched the mailing list archive?===
** Please state whether you are using version 0.18, version 0.18.1, 0.19, etc.
+
* The archive can be found at http://www.gossamer-threads.com/lists/mythtv/users/
** If you are using a version from SVN then you '''must''' include the version number. To find the SVN version number you can use <code>svn info</code> while in the mythtv directory. The current version will be displayed, along with other information.
+
* To search it using Google, use this 'site:www.gossamer-threads.com/lists/mythtv/users/' as part of your [http://www.google.com/search?hl=en&q=site%3Awww.gossamer-threads.com%2Flists%2Fmythtv%2Fusers%2F&btnG=Google+Search&meta= Google search]
 +
* Search http://google.com as well - there is a chance that your issue isn't a mythtv-specific issue and the answer to your question is out there. TIP: include "re:" in your search to look for responses. Answers and solutions are usually in responses.
  
* What have you done?
+
===Which version of Myth are you using?===
** What steps have you carried out to isolate your problem? This helps other users to determine whether your your problem is hardware, software, driver or MythTV related.
+
* Please state whether you are using version 0.18, version 0.18.1, 0.19, 0.20, etc.
** How reproducible is your problem?  Does this happen every time you use Myth, every time your system is under load, at a specific time of day, during a particular show, on a particular channel?
+
* If you are using a version from SVN then you '''must''' include the version number.  To find the SVN version number you can use <code>svn info</code> while in the mythtv directory.  The current version will be displayed, along with other information.
 +
* Aside from MythTV version, what other information might be helpful to include? It never hurts to include your distribution name and version. If you are using mythtv binary packages, include the binary distribution source/name and version numbers.
 +
* If your hardware or config details are unusual or noteworthy and you suspect that information may be pertinent, include it.
  
* Have you forgotten something?
+
===What have you done?===
** '''''Always''''' read your message several times before posting it. Think about all the things that might intersect with your problem. Have you looked at all of them?
+
* What steps have you carried out to isolate your problem? This helps other users to determine whether your your problem is hardware, software, driver or MythTV related.
 +
* How reproducible is your problem?  Does this happen every time you use Myth, every time your system is under load, at a specific time of day, during a particular show, on a particular channel?
 +
* Refine your reproducible testcase to the simplest possible case. If more people can reproduce your problem, you're more likely to get help or a fix.
 +
* Include any relevant log file information like the output from mythbackend, output from mythfrontend, output from /var/log/messages, error message during compile. NOTE: Only include the relevant information.
 +
** It's okay to trim mundane stuff out of logfiles in most circumstances.
 +
** You should ''always'' trim log information from previous runs of the program. Failing to do so will confuse those trying to help.
 +
** If asked to provide full log files or "log output from a run of" an application, please provide full log files. Generally this request indicates that in trimming the log file, you removed too much information, and some important information was lost.
 +
** Remember that a user who can't figure out why his system isn't working is not the best person to determine what information in the log file is relevant. In theory, if the user understood all of the log messages, he or she wouldn't need to ask for help.
 +
** If you're not sure, include information you think is relevant as part of the message, but attach complete log files separately, or include a link to the log files on http://www.pastebin.com/ or other online file/paste sharing site.
 +
* Have you done any debugging of this? Can you generate a backtrace? When did it work last? What have you done since? Help us help you.
 +
* Have you looked for help on [http://www.mythtv.org/docs/mythtv-HOWTO-1.html#ss1.7 IRC]? Perhaps a current issue has been discussed on IRC and is in the [http://mythtv.beirdo.ca/ircLog/ IRC logs]?
  
* Use a descriptive subject line
+
===Have you forgotten something?===
** "I have a problem with Myth!" is not a helpful title. "Myth crashes when I enter live TV with a PVR500" is. The clearer and more specific your title is without being overly long will help people know what your email is about and will most likely result in a quicker reply.
+
* '''''Always''''' read your message several times before posting it.  Think about all the things that might intersect with your problem. Have you looked at all of them?
** If your message is off topic (not having to do with MythTV directly) please begin your subject line with "OT:"
+
* Tell us what *research* you've already done and what you found... reference posts in the archives if they were helpful, or if they pointed you in a certain direction. You're more likely to get help if you demonstrate that you've already searched on google and gossamer-threads.
  
* Finally, don't repost your message too soon
+
===Use a descriptive subject line===
** Although we all know that your issue is simply the '''''most''''' important thing on the planet, not everyone reads mythtv-users every hour, or even every day.  It might be a few days before someone responds to your message.
+
* "I have a problem with Myth!" is not a helpful title. "Mythfrontend crashes entering live TV with PVR500" is. The clearer and more specific your title is without being overly long will help people know what your email is about and will most likely result in a quicker reply.
** If you do feel the need to remind the list about your message, then you should add what steps you've taken since your intial post.
+
* If your message is off-topic (not having to do with MythTV directly) please begin your subject line with "OT:"
** Don't change the subject line, simply responding is enough to "bump" the message. If your original subject line is poor (see above) then you may want to change it to something more descriptivve. This helps keep threads together and does not leave "hanging" threads in gossamer in search results.
+
 
 +
===Be nice===
 +
* While you might have years of experience, an ego the size of a small Afican country, or some other form of accrediation, there are many different people on the list with an enormous variation in skillset; many new to Linux, many new to MythTV, and many experienced users.  Belittling someone's response, lashing out at what looks to be obvious errors, or just being harsh because of a poster's past postings do not add to the quality of the list content.
 +
* '''Don't Write Angry'''.  If something on the list has you so fired up that you find yourself furiously typing away a "shoot-from-the-hip" response, and you are re-reading the message several times over just to make sure that every word you have written drives your point home, '''don't send it'''.  Wait a little bit to collect your thoughts and compose a more professional and clean response.
 +
* Avoid flame wars.  They just don't do anything but anger a lot of people, create a lot of noise, and fill up the archive (and everyone's mail boxes) with a lot of useless garbage.  Like your Mother/Father/Wise-Person-Who-Mentored-You used to say "If you can't saying anything nice about someone, don't say anything at all."  In other words, no one else wants to hear it.
 +
 
 +
===No URL shorteners===
 +
Please use full URLs when linking to websites.  Tools such as bit.ly and j.mp serve to mask the address you are sending.  Without knowing where they are going, other users are unable to judge whether that site is safe or worthwhile accessing.  It's not like this is twitter or instant messaging with character limits.
 +
 
 +
===Finally, don't repost your message too soon===
 +
* Although we all know that your issue is simply the '''''most''''' important thing on the planet, not everyone reads mythtv-users every hour, or even every day.  It might be a few days before someone responds to your message.
 +
* If you do feel the need to remind the list about your message, then you should add what steps you've taken since your initial post.
 +
* Don't change the subject line, simply responding is enough to "bump" the message. If your original subject line is poor (see above) then you may want to change it to something more descriptive. This helps keep threads together and does not leave "hanging" threads in gossamer in search results.
 +
 
 +
===Do not use the the mailing list for advertising===
 +
* Isaac has stressed several times advertising is inappropriate.  This includes individuals selling individual items.
 +
 
 +
===Got your solution?  Share it!===
 +
* If the solution that you have come up with was not available here on the MythTV, consider [http://www.mythtv.org/wiki/index.php/Special:Userlogin contributing it]!
  
 
==Frequently Asked Questions==
 
==Frequently Asked Questions==
 +
===Should I ask this question on mythtv-dev or mythtv-users?===
 +
 +
If your question is directly related to the development of MythTV (especially if you are a developer of MythTV) then mythtv-dev is possibly the correct venue for your question.  Please note that the developers don't particularly like having people interrupting them with questions that don't belong on their list, so if you are off-topic, expect to get snapped at. Typically there are a number of developers that hang out on the mythtv-users, and if they can help you out, they will, so there is no use posting on the wrong list.
 +
 +
So in short, all user, usage, and setup issues belong on mythtv-users, not mythtv-dev.
 +
 
===Why don't we have a web based forum instead of this mailing list?===
 
===Why don't we have a web based forum instead of this mailing list?===
 
This is a question that comes up on a regular basis, so unless you have a fascinating new insight into the matter it's probably best not to bring it up. Basically there are pros and cons to both mailing lists and forums; however we have a mailing list because:
 
This is a question that comes up on a regular basis, so unless you have a fascinating new insight into the matter it's probably best not to bring it up. Basically there are pros and cons to both mailing lists and forums; however we have a mailing list because:
  
* Many users prefer managing text only emails to the graphics adverts etc that are associated with forums.
+
* Many users prefer managing text only emails to the graphics, adverts etc., that are associated with forums.
* Somebody would have to provide (i.e pay for) the bandwith and servers needed to run a forum.
+
* Somebody would have to provide (i.e pay for) the bandwidth and servers needed to run a forum.
 
* Web based forums are difficult to archive.
 
* Web based forums are difficult to archive.
 
* Most email clients such as [http://www.mozilla.com Thunderbird] (and [http://www.google.com/gmail Gmail] if you like web based mail) can be configured to make dealing with mailing lists surprisingly easy.
 
* Most email clients such as [http://www.mozilla.com Thunderbird] (and [http://www.google.com/gmail Gmail] if you like web based mail) can be configured to make dealing with mailing lists surprisingly easy.
  
There is a web-based archive of the list at [http://www.gossamer-threads.com/archive/MythTV_C2/Users_F11/ Gossamer Threads] if you really want a web-forum look-alike.
+
There are two known web-based archives of the list:
 +
[http://www.gossamer-threads.com/archive/MythTV_C2/Users_F11/ Gossamer Threads] if you really want a web-forum look-alike, or
 +
*  [http://www.nabble.com/MythTV-f15552.html Nabble] for search, threading, and (with an account) posting via the web.
  
 
===Why don't my emails appear on the list?===
 
===Why don't my emails appear on the list?===
 
You've probably set your preferences so that you don't receive your own emails from the list.  To change this you need to go to the [http://mythtv.org/cgi-bin/mailman/options/mythtv-users mailing list options page].  Fill in your email address and password.  (Use the forgotten password link if necessary.)  The fourth and fifth options in the table are the ones that you want to look at.  You can also turn off list delivery for a while, for instance if you are going away for a while and don't want your Inbox filling up.
 
You've probably set your preferences so that you don't receive your own emails from the list.  To change this you need to go to the [http://mythtv.org/cgi-bin/mailman/options/mythtv-users mailing list options page].  Fill in your email address and password.  (Use the forgotten password link if necessary.)  The fourth and fifth options in the table are the ones that you want to look at.  You can also turn off list delivery for a while, for instance if you are going away for a while and don't want your Inbox filling up.
  
Additionally, if you are using Gmail, then your own posts to the list are [http://mail.google.com/support/bin/answer.py?answer=10314&topic=1564 hidden] [http://mail.google.com/support/bin/answer.py?answer=6588&topic=1564 by Gmail].  They have a page to explain why, but not how to turn it off.
+
Additionally, if you are using Gmail, then your own posts to the list are [http://mail.google.com/support/bin/answer.py?hl=en&answer=6588 hidden by Gmail].  They have a page to explain why, but not how to turn it off. If you're a Gmail user, then you can check your message really hasn't appeared on the list by [http://www.gossamer-threads.com/lists/mythtv/users/ looking at the archive].
  
 
===Anything else I should be aware of?===
 
===Anything else I should be aware of?===
Three good rules to follow are:
+
Some good rules to follow are:
  
# Do a search of the [http://www.gossamer-threads.com/archive/MythTV_C2/Users_F11/ mailing list archives] before asking a question.
+
# Search the mailing list archives ([http://www.gossamer-threads.com/archive/MythTV_C2/Users_F11/ Gossamer] or [http://www.nabble.com/MythTV-f15552.html Nabble]) before asking a question.
#:There's a wealth of information there. Also check out the [[MythTV]] Docs to see if your question is answered there. If you're new to mailing lists in general try to learn a bit about netiquette from a site such as this one.  
+
#:There's a wealth of information there. Also check out the [[MythTV]] Docs to see if your question is answered there. If you're new to mailing lists in general try to learn a bit about netiquette from a site such as this one.
 +
#:Read [http://www.catb.org/~esr/faqs/smart-questions.html How to ask questions the smart way] - NOTE: this external site is *NOT* a mythtv support site.
 
# When starting a new topic (or thread) [mailto:mythtv-users@mythtv.org create a new email].
 
# When starting a new topic (or thread) [mailto:mythtv-users@mythtv.org create a new email].
 
#: If you just reply to an existing message and change the subject your message may get threaded under the message you are replying to.  This is undesirable as many people will not even see your message.
 
#: If you just reply to an existing message and change the subject your message may get threaded under the message you are replying to.  This is undesirable as many people will not even see your message.
 +
# Make sure your email client is properly configured.
 +
#: If your email client generates a new thread when you respond to someone's email, then it is not properly configured. Thread-splitting is not appreciated.
 +
#: Replying to digest emails is also frowned upon. Please just subscribe and reply to individual messages.
 
# Try not to stray too far off topic.
 
# Try not to stray too far off topic.
 
#: By all means tell us if you think something is of interest to the Myth Community, but requesting things like Gmail invites or informing us of the latest free Ipods.com offer is really not a good thing to do.
 
#: By all means tell us if you think something is of interest to the Myth Community, but requesting things like Gmail invites or informing us of the latest free Ipods.com offer is really not a good thing to do.
 +
# Discussion of any topics that may be considered illegal or questionably legal in any of the areas that MythTV developers and/or users reside (especially the United States as the mailing lists are hosted in the United States) is prohibited.  Similarly, discussion of topics that are in violation of the Terms of Service/Terms of Use of any service (including cable or satellite TV or web services, such as video streaming sites or television listings sites) is prohibited.
 +
#: Do not even mention these things in passing within another discussion.
 +
#: This is non-negotiable.
 +
#: Making it "hypothetical" does not make it OK.
 +
#: These rules are meant to protect the MythTV developers and the project itself.  Even if you feel that your actions are not in violation of any laws, terms of service, contracts, or rules of ethics, please consider how an outsider who has not followed the thread and/or sees only parts of your post out of context and/or who may live in an area whose laws differ from yours may interpret your statements.  In the past, the MythTV project has already been painted as just another tool used by file sharers and copyright violators in a New York Times article entitled, "[http://www.nytimes.com/2005/01/30/arts/television/30manl.html?ex=1264741200&en=e82b9db497df2928&ei=5090&partner=rssuserland Steal This Show]".
 +
#: Prohibited topics include (but are not limited to):
 +
## Discussion of copying and/or distributing video obtained via MythTV recording
 +
## Discussion of acquiring video via any means other than through recording with MythTV
 +
## Discussion of the use of softcam to decrypt encrypted digital broadcasts
 +
## Discussion of any means of obtaining programming illegally or through means which may be a violation of copyright laws or terms of service

Revision as of 19:08, 7 May 2012

This could turn out to be a random list of points. Any editing is more than welcome!

General Mailing List Etiquette

Posting Style

Post in plain text

  • Plain text messages are significantly smaller in size and can dramatically reduce mail server load when sending your message to thousands of subscribers.
  • Reduced message size helps people on dial-up connections or with limited email quotas.
  • Plain text can be interpreted by all mail clients.
  • Plain text rendering is consistent within a user's mail client. I don't care what font, font size, or color you like.
  • Plain text is easier to prune in responses than html text.

If you are using Outlook or Outlook Express you can add the address of the mailing list to your address book and then enable to option to "send messages in plain text to this recipient". Here's some information on configuring these and other clients & web-mail gateways to send in plain text.

Bottom post

  • Bottom posting means adding your reply to the bottom of the previous message. This is easily achieved in most mail clients by pressing [Ctrl] and [End] before doing any other typing.
  • The reason for bottom posting is best summed up in the following piece of text (hint, try reading it first from the top to the bottom, then try reading it from the bottom to the top):
    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 on usenet and in e-mail?
  • Bottom posting works best with the MythTV-users list because it allows for easier reading of individual messages by making it possible to follow exactly what the conversation is about and where it currently is without having to dig back through previous messages or drill down through the current message. Top posting is typically and more efficiently used in one-to-one email communications rather than on a mailing list.
  • An acceptable alternative to bottom posting is interleaving your responses with the previous message. This can help the flow of a message if the subject matter is complicated. If you do this, make sure that the previous message has each line prefixed with '>' or similar to denote that it is not your writing.
    • An optional method for formatting interleaved posts for easier reading is to leave 1 blank line between your text and what your responding to and two blank lines after your text and the next section of quoted text.

Trim your message

  • Always remove any unneeded parts of the previous message or thread. This always includes the footer and signature from the previous message.
  • If the previous message is long and complicated and you are replying to only one part, only include that part in your reply.
  • Less is more. Don't be fearful of deleting some content from the original posting or previous responses.

Message Content

  • Keep the Language Simple
    • Don't assume that list subscribers are native English speakers. Keep your message simple so that we all understand you.
    • Simpler messages are easier to read. Messages that are difficult to read or understand will get fewer and less helpful responses.
  • Don't over-simplify
    • As a poster, do not assume that a majority of the people out there are running the exact same hardware, with the exact same configuration, or with the exact same issue(s) that you are experiencing. Try to be descriptive to the point of informative. A simple "It doesn't work" message will not generate the response you are looking for.
    • As a responder, do not assume that the individual you are responding to is as savvy or more savvy than yourself. Remember, you are not necessarily just responding to the original poster, you are responding to everyone else on the list. You might be helping out a lot more people that you think you are.

MythTV-users specific etiquette

Stay on point / Stay on Topic

  • This is the MythTV users mailing list, after all. It is generally frowned upon to ask questions regarding items unrelated to MythTV (eg: "How do I build a computer?", "How to install MySQL", etc). However, keep in mind that there are questions that are not directly related to MythTV but are related to your specific setup of MythTV. Some list members may frown on such messages on the mailing list, but, again, this is the users mailing list and, as such, they are acceptable. Please use some form of judgement when posting off topic questions or messages to the list.
  • If a conversation drifts so far away from the original topic, start a new thread. Nothing is worse than following a thread only to see that the message titled "problems with lirc" only contains information about various IR receivers, cases, and power supplies. This is most noticable when you are performing searches in the archives of the list and you are the one looking for a particular solution: you're forced to wade through many (in some cases, dozens) of off topic emails to find the email containing the solution you are looking for.

Please don't cross post

  • Posts shouldn't be sent to both -dev and -users lists. If you're not sure which list is appropriate, start with -users until you're asked to move it to -dev.

Have you searched the mailing list archive?

  • The archive can be found at http://www.gossamer-threads.com/lists/mythtv/users/
  • To search it using Google, use this 'site:www.gossamer-threads.com/lists/mythtv/users/' as part of your Google search
  • Search http://google.com as well - there is a chance that your issue isn't a mythtv-specific issue and the answer to your question is out there. TIP: include "re:" in your search to look for responses. Answers and solutions are usually in responses.

Which version of Myth are you using?

  • Please state whether you are using version 0.18, version 0.18.1, 0.19, 0.20, etc.
  • If you are using a version from SVN then you must include the version number. To find the SVN version number you can use svn info while in the mythtv directory. The current version will be displayed, along with other information.
  • Aside from MythTV version, what other information might be helpful to include? It never hurts to include your distribution name and version. If you are using mythtv binary packages, include the binary distribution source/name and version numbers.
  • If your hardware or config details are unusual or noteworthy and you suspect that information may be pertinent, include it.

What have you done?

  • What steps have you carried out to isolate your problem? This helps other users to determine whether your your problem is hardware, software, driver or MythTV related.
  • How reproducible is your problem? Does this happen every time you use Myth, every time your system is under load, at a specific time of day, during a particular show, on a particular channel?
  • Refine your reproducible testcase to the simplest possible case. If more people can reproduce your problem, you're more likely to get help or a fix.
  • Include any relevant log file information like the output from mythbackend, output from mythfrontend, output from /var/log/messages, error message during compile. NOTE: Only include the relevant information.
    • It's okay to trim mundane stuff out of logfiles in most circumstances.
    • You should always trim log information from previous runs of the program. Failing to do so will confuse those trying to help.
    • If asked to provide full log files or "log output from a run of" an application, please provide full log files. Generally this request indicates that in trimming the log file, you removed too much information, and some important information was lost.
    • Remember that a user who can't figure out why his system isn't working is not the best person to determine what information in the log file is relevant. In theory, if the user understood all of the log messages, he or she wouldn't need to ask for help.
    • If you're not sure, include information you think is relevant as part of the message, but attach complete log files separately, or include a link to the log files on http://www.pastebin.com/ or other online file/paste sharing site.
  • Have you done any debugging of this? Can you generate a backtrace? When did it work last? What have you done since? Help us help you.
  • Have you looked for help on IRC? Perhaps a current issue has been discussed on IRC and is in the IRC logs?

Have you forgotten something?

  • Always read your message several times before posting it. Think about all the things that might intersect with your problem. Have you looked at all of them?
  • Tell us what *research* you've already done and what you found... reference posts in the archives if they were helpful, or if they pointed you in a certain direction. You're more likely to get help if you demonstrate that you've already searched on google and gossamer-threads.

Use a descriptive subject line

  • "I have a problem with Myth!" is not a helpful title. "Mythfrontend crashes entering live TV with PVR500" is. The clearer and more specific your title is without being overly long will help people know what your email is about and will most likely result in a quicker reply.
  • If your message is off-topic (not having to do with MythTV directly) please begin your subject line with "OT:"

Be nice

  • While you might have years of experience, an ego the size of a small Afican country, or some other form of accrediation, there are many different people on the list with an enormous variation in skillset; many new to Linux, many new to MythTV, and many experienced users. Belittling someone's response, lashing out at what looks to be obvious errors, or just being harsh because of a poster's past postings do not add to the quality of the list content.
  • Don't Write Angry. If something on the list has you so fired up that you find yourself furiously typing away a "shoot-from-the-hip" response, and you are re-reading the message several times over just to make sure that every word you have written drives your point home, don't send it. Wait a little bit to collect your thoughts and compose a more professional and clean response.
  • Avoid flame wars. They just don't do anything but anger a lot of people, create a lot of noise, and fill up the archive (and everyone's mail boxes) with a lot of useless garbage. Like your Mother/Father/Wise-Person-Who-Mentored-You used to say "If you can't saying anything nice about someone, don't say anything at all." In other words, no one else wants to hear it.

No URL shorteners

Please use full URLs when linking to websites. Tools such as bit.ly and j.mp serve to mask the address you are sending. Without knowing where they are going, other users are unable to judge whether that site is safe or worthwhile accessing. It's not like this is twitter or instant messaging with character limits.

Finally, don't repost your message too soon

  • Although we all know that your issue is simply the most important thing on the planet, not everyone reads mythtv-users every hour, or even every day. It might be a few days before someone responds to your message.
  • If you do feel the need to remind the list about your message, then you should add what steps you've taken since your initial post.
  • Don't change the subject line, simply responding is enough to "bump" the message. If your original subject line is poor (see above) then you may want to change it to something more descriptive. This helps keep threads together and does not leave "hanging" threads in gossamer in search results.

Do not use the the mailing list for advertising

  • Isaac has stressed several times advertising is inappropriate. This includes individuals selling individual items.

Got your solution? Share it!

  • If the solution that you have come up with was not available here on the MythTV, consider contributing it!

Frequently Asked Questions

Should I ask this question on mythtv-dev or mythtv-users?

If your question is directly related to the development of MythTV (especially if you are a developer of MythTV) then mythtv-dev is possibly the correct venue for your question. Please note that the developers don't particularly like having people interrupting them with questions that don't belong on their list, so if you are off-topic, expect to get snapped at. Typically there are a number of developers that hang out on the mythtv-users, and if they can help you out, they will, so there is no use posting on the wrong list.

So in short, all user, usage, and setup issues belong on mythtv-users, not mythtv-dev.

Why don't we have a web based forum instead of this mailing list?

This is a question that comes up on a regular basis, so unless you have a fascinating new insight into the matter it's probably best not to bring it up. Basically there are pros and cons to both mailing lists and forums; however we have a mailing list because:

  • Many users prefer managing text only emails to the graphics, adverts etc., that are associated with forums.
  • Somebody would have to provide (i.e pay for) the bandwidth and servers needed to run a forum.
  • Web based forums are difficult to archive.
  • Most email clients such as Thunderbird (and Gmail if you like web based mail) can be configured to make dealing with mailing lists surprisingly easy.

There are two known web-based archives of the list:

  • Gossamer Threads if you really want a web-forum look-alike, or
  • Nabble for search, threading, and (with an account) posting via the web.

Why don't my emails appear on the list?

You've probably set your preferences so that you don't receive your own emails from the list. To change this you need to go to the mailing list options page. Fill in your email address and password. (Use the forgotten password link if necessary.) The fourth and fifth options in the table are the ones that you want to look at. You can also turn off list delivery for a while, for instance if you are going away for a while and don't want your Inbox filling up.

Additionally, if you are using Gmail, then your own posts to the list are hidden by Gmail. They have a page to explain why, but not how to turn it off. If you're a Gmail user, then you can check your message really hasn't appeared on the list by looking at the archive.

Anything else I should be aware of?

Some good rules to follow are:

  1. Search the mailing list archives (Gossamer or Nabble) before asking a question.
    There's a wealth of information there. Also check out the MythTV Docs to see if your question is answered there. If you're new to mailing lists in general try to learn a bit about netiquette from a site such as this one.
    Read How to ask questions the smart way - NOTE: this external site is *NOT* a mythtv support site.
  2. When starting a new topic (or thread) create a new email.
    If you just reply to an existing message and change the subject your message may get threaded under the message you are replying to. This is undesirable as many people will not even see your message.
  3. Make sure your email client is properly configured.
    If your email client generates a new thread when you respond to someone's email, then it is not properly configured. Thread-splitting is not appreciated.
    Replying to digest emails is also frowned upon. Please just subscribe and reply to individual messages.
  4. Try not to stray too far off topic.
    By all means tell us if you think something is of interest to the Myth Community, but requesting things like Gmail invites or informing us of the latest free Ipods.com offer is really not a good thing to do.
  5. Discussion of any topics that may be considered illegal or questionably legal in any of the areas that MythTV developers and/or users reside (especially the United States as the mailing lists are hosted in the United States) is prohibited. Similarly, discussion of topics that are in violation of the Terms of Service/Terms of Use of any service (including cable or satellite TV or web services, such as video streaming sites or television listings sites) is prohibited.
    Do not even mention these things in passing within another discussion.
    This is non-negotiable.
    Making it "hypothetical" does not make it OK.
    These rules are meant to protect the MythTV developers and the project itself. Even if you feel that your actions are not in violation of any laws, terms of service, contracts, or rules of ethics, please consider how an outsider who has not followed the thread and/or sees only parts of your post out of context and/or who may live in an area whose laws differ from yours may interpret your statements. In the past, the MythTV project has already been painted as just another tool used by file sharers and copyright violators in a New York Times article entitled, "Steal This Show".
    Prohibited topics include (but are not limited to):
    1. Discussion of copying and/or distributing video obtained via MythTV recording
    2. Discussion of acquiring video via any means other than through recording with MythTV
    3. Discussion of the use of softcam to decrypt encrypted digital broadcasts
    4. Discussion of any means of obtaining programming illegally or through means which may be a violation of copyright laws or terms of service