261
edits
m (Add section on mailing list archives / search facilities, with a useful archive website mentioned in a mailinglist discussion) |
(Overhaul the Mailing lists article) |
||
| Line 3: | Line 3: | ||
Some questions are better asked on the mailing list instead of the forum, especially those related to core development or project infrastructure, but you do not strictly have to be a core developer to subscribe and/or post to the mailing lists. | Some questions are better asked on the mailing list instead of the forum, especially those related to core development or project infrastructure, but you do not strictly have to be a core developer to subscribe and/or post to the mailing lists. | ||
== | == Overview of mailing lists== | ||
===Discussion lists=== | |||
Discussion lists are used by the FlightGear contributor community to discuss work on the FlightGear project. | |||
{| class="wikitable" | {| class="wikitable" | ||
! List | !List | ||
! Contents | !Status | ||
!Contents | |||
<!-- ! Status --> | <!-- ! Status --> | ||
! Archive | !Archive | ||
! Subscribe | |||
! E-mail address | !Subscribe | ||
! Remarks | !E-mail address | ||
!Remarks | |||
<!-- | <!-- | ||
| rowspan="1" style="background: #33cf83; color: black; vertical-align: middle; text-align: center;" | Active | | rowspan="1" style="background: #33cf83; color: black; vertical-align: middle; text-align: center;" | Active | ||
| Line 18: | Line 23: | ||
--> | --> | ||
|- | |- | ||
| flightgear-announce | | rowspan="1" style="background: green; color: black; vertical-align: middle;" |flightgear-devel | ||
| FlightGear announcements | |Active | ||
| {{Mailing list archive|flightgear-announce}} | |FlightGear developer discussions | ||
| {{Mailing list subscription link|flightgear-announce}} | |{{Mailing list archive|flightgear-devel}} | ||
| {{Mailing list e-mail address|flightgear-announce}} | |{{Mailing list subscription link|flightgear-devel}} | ||
|{{Mailing list e-mail address|flightgear-devel}} | |||
|Most active list (primary) | |||
|- | |||
| rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" |flightgear-announce | |||
|Inactive | |||
|FlightGear announcements | |||
|{{Mailing list archive|flightgear-announce}} | |||
| | |||
{{Mailing list subscription link|flightgear-announce}} | |||
|{{Mailing list e-mail address|flightgear-announce}} | |||
| Last post 2015 | | Last post 2015 | ||
|- | |- | ||
| rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" | flightgear-bugs | | rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" |flightgear-bugs | ||
| Bug tracker messages | |Inactive | ||
| {{Mailing list archive|flightgear-bugs}} | | Bug tracker messages '''(no longer for reporting bugs)''' | ||
| {{Mailing list subscription link|flightgear-bugs}} | |{{Mailing list archive|flightgear-bugs}} | ||
| {{Mailing list e-mail address|flightgear-bugs}} | |{{Mailing list subscription link|flightgear-bugs}} | ||
| | |{{Mailing list e-mail address|flightgear-bugs}} | ||
|'''Deprecated in favor of the {{Create ticket|issue tracker}}.''' | |||
|- | |- | ||
| flightgear- | | rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" | flightgear-flightmodel | ||
| | |Inactive | ||
| {{Mailing list archive|flightgear- | |Flight model discussions | ||
| {{Mailing list subscription link|flightgear- | |{{Mailing list archive|flightgear-flightmodel}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-flightmodel}} | ||
| | |{{Mailing list e-mail address|flightgear-flightmodel}} | ||
| Last post 2017. | |||
|- | |- | ||
| flightgear- | | rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" |flightgear-newsletter | ||
| | |Inactive | ||
| {{Mailing list archive|flightgear- | |[[FlightGear Newsletter|Newsletter]] announcements and discussions | ||
| {{Mailing list subscription link|flightgear- | |{{Mailing list archive|flightgear-newsletter}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-newsletter}} | ||
| | |{{Mailing list e-mail address|flightgear-newsletter}} | ||
|Last post 2012 | |||
|- | |- | ||
| rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" | flightgear- | | rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" |flightgear-scenery | ||
| | |Inactive | ||
| {{Mailing list archive|flightgear- | |Discussion of scenery development: code, tools, GIS data, models, etc. | ||
| {{Mailing list subscription link|flightgear- | |{{Mailing list archive|flightgear-scenery}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-scenery}} | ||
| | |{{Mailing list e-mail address|flightgear-scenery}} | ||
| | |||
|- | |- | ||
| rowspan="1" style="background: | | rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" |flightgear-users | ||
| FlightGear | | Inactive | ||
| {{Mailing list archive|flightgear- | | FlightGear user discussions | ||
| {{Mailing list subscription link|flightgear- | |{{Mailing list archive|flightgear-users}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-users}} | ||
| | |{{Mailing list e-mail address|flightgear-users}} | ||
|Mostly replaced by [http://forum.flightgear.org the forum] | |||
|} | |||
===Automated lists=== | |||
These mailing lists are not used for discussion, but are intended to provide information for developers about the status of builds and commit activity. | |||
{| class="wikitable" | |||
!List | |||
!Status | |||
!Contents | |||
<!-- ! Status --> | |||
!Archive | |||
!Subscribe | |||
!E-mail address | |||
!Remarks | |||
<!-- | |||
| rowspan="1" style="background: #33cf83; color: black; vertical-align: middle; text-align: center;" | Active | |||
| rowspan="1" style="background: #ffe344; color: black; vertical-align: middle; text-align: center;" | Quiet | |||
| rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle; text-align: center;" | Inactive | |||
--> | |||
|- | |- | ||
| flightgear- | | rowspan="1" style="background: green; color: black; vertical-align: middle;" |flightgear-builds | ||
| | |Active | ||
| {{Mailing list archive|flightgear- | |Chatter from the FlightGear build servers | ||
| {{Mailing list subscription link|flightgear- | |{{Mailing list archive|flightgear-builds}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-builds}} | ||
| | |{{Mailing list e-mail address|flightgear-builds}} | ||
| | |||
|- | |- | ||
| flightgear- | | rowspan="1" style="background: green; color: black; vertical-align: middle;" |flightgear-commitlogs | ||
| | |Active | ||
| {{Mailing list archive|flightgear- | |Source code change commit logs | ||
| {{Mailing list subscription link|flightgear- | | {{Mailing list archive|flightgear-commitlogs}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-commitlogs}} | ||
| | |{{Mailing list e-mail address|flightgear-commmitlogs}} | ||
| | |||
|- | |- | ||
| rowspan="1" style="background: | | rowspan="1" style="background: green; color: black; vertical-align: middle;" |flightgear-fgaddon-commitlogs | ||
| [[ | |Active | ||
| {{Mailing list archive|flightgear- | |Commit logs for the [[FGAddon]] repository (content developers) | ||
| {{Mailing list subscription link|flightgear- | |{{Mailing list archive|flightgear-fgaddon-commitlogs}} | ||
| {{Mailing list e-mail address|flightgear- | |{{Mailing list subscription link|flightgear-fgaddon-commitlogs}} | ||
| | |{{Mailing list e-mail address|flightgear-fgaddon-commitlogs}} | ||
| | |||
|- | |- | ||
| | | rowspan="1" style="background: #ff6e67; color: black; vertical-align: middle;" |flightgear-cvslogs | ||
|Inactive | |||
|CVS commit logs | |||
|{{Mailing list archive|flightgear-cvslogs}} | |||
| | | | ||
| | {{Mailing list subscription link|flightgear-cvslogs}} | ||
|{{Mailing list e-mail address|flightgear-cvslogs}} | |||
|Apparently dismissed. Last post 2010. | |||
| {{Mailing list archive|flightgear- | |||
| {{Mailing list subscription link|flightgear- | |||
| {{Mailing list e-mail address|flightgear- | |||
| | |||
|} | |} | ||
== | ==Subscribing to a mailing list== | ||
To sign up for one of the above mailing lists, follow these steps: | To sign up for one of the above mailing lists, follow these steps: | ||
# Click a '''Subscribe''' link in the list above to get to the mailing list subscription form.[[File:SourceForge_Mailing_List_Signup_Page.png|none|thumb|795x795px]] | |||
# Click a '''Subscribe''' link in the list above to get to the mailing list subscription form. | #Enter your e-mail address in the '''Email''' field. | ||
# Enter your e-mail address in the ''' | #Select your country in the '''Country''' field. | ||
# | #Select whether you wish to receive '''SourceForge Newsletters.''' | ||
# | #Agree to the '''SourceForge''' '''Privacy Policy.''' | ||
# | <ol start="3"> | ||
<li> Click the {{button|Subscribe}} button. </li> | |||
<ol start="3"> | <li> You will be sent a confirmation e-mail, go to your email client and open the confirmation email (check your Spam folder if necessary). </li> | ||
<li>Click the {{button|Subscribe}} button.</li> | <li>Click on '''Confirm Your Subscription.''' [[File:Mailing_List_Email_Confirmation.png|none|thumb|813x813px]] </li> | ||
<li>You will be sent a confirmation e-mail | <li>This will take you to a SourceForge page confirming that you have successfully joined the mailing list. You can close this tab.[[File:Mailing_list_confirmation_complete.png|none|thumb|815x815px]]</li> | ||
<li> | <li>Afterwards, you will receive a welcome email from SourceForge summarizing the details of your subscription.{{warning|SourceForge will send you an auto-generated password in cleartext in the welcome email. This has certain security implications, and it is strongly recommended that you should not re-use this password anywhere else.}} | ||
</ol> | [[File:Mailing_list_welcome_message.png|frameless|819x819px]] | ||
</li> | |||
</ol> | |||
== Posting to mailing lists == | ==Posting to mailing lists== | ||
To protect list subscribers from spam, you are allowed to post there only after you have subscribed, and to send e-mails from the address you are subscribed with.<ref name="MLPolicy">{{cite web | To protect list subscribers from spam, you are allowed to post there only after you have subscribed, and to send e-mails from the address you are subscribed with.<ref name="MLPolicy">{{cite web | ||
|url = https://forum.flightgear.org/viewtopic.php?p=244916 | |url = https://forum.flightgear.org/viewtopic.php?p=244916 | ||
| Line 139: | Line 167: | ||
Keep in mind that getting a response from the lists is usually slower than the forum and that responses may take several days. Should it take more than a week, you might want to probe the interest by responding to your own message; sometimes, there might be no reply as there is none. | Keep in mind that getting a response from the lists is usually slower than the forum and that responses may take several days. Should it take more than a week, you might want to probe the interest by responding to your own message; sometimes, there might be no reply as there is none. | ||
== Report bugs to the issue tracker == | ==Report bugs to the issue tracker == | ||
Bugs should preferably be {{create ticket|reported to the issue tracker}} instead of posting them to a mailing list. | Bugs should preferably be {{create ticket|reported to the issue tracker}} instead of posting them to a mailing list. | ||
You may have to {{register to sf|register a SourceForge account}} first. | You may have to {{register to sf|register a SourceForge account}} first. | ||
== Mailing list archives == | == Mailing list archives== | ||
Searchable archives are available at [https://marc.info/?l=flightgear-devel&r=1&w=2 '''marc.info''']. This site allows searching by topic name, searching by content of mailing list posts, browsing each month's topics, and searching by author. It doesn't have a thread view, but it has links to the next and previous posts in each topic thread. | Searchable archives are available at [https://marc.info/?l=flightgear-devel&r=1&w=2 '''marc.info''']. This site allows searching by topic name, searching by content of mailing list posts, browsing each month's topics, and searching by author. It doesn't have a thread view, but it has links to the next and previous posts in each topic thread. | ||
| Line 151: | Line 179: | ||
The mailing lists are also searchable from the [https://sourceforge.net/p/flightgear/mailman/search/?q= sourceforge website]. Tips: Try searching the relevant mailing list e.g. 'fg-devel', increasing number of results, and click on the post date column to change sorting order from newest to oldest. Each results contains a view entire thread link down the bottom, but as of writing this (April 2021), the thread view is a broken or inconsistent. | The mailing lists are also searchable from the [https://sourceforge.net/p/flightgear/mailman/search/?q= sourceforge website]. Tips: Try searching the relevant mailing list e.g. 'fg-devel', increasing number of results, and click on the post date column to change sorting order from newest to oldest. Each results contains a view entire thread link down the bottom, but as of writing this (April 2021), the thread view is a broken or inconsistent. | ||
== External links == | ==External links== | ||
* [http://www.flightgear.org/mail.html FlightGear mailing list details] | *[http://www.flightgear.org/mail.html FlightGear mailing list details] | ||
* [ | *[[sourceforge:p/flightgear/mailman/|List of all project mailing lists on SourceForge]] | ||
{{appendix}} | {{appendix}} | ||
edits