Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-eresources.mdwn
1 \r
2 \r
3 ## Appendix Resources on the Internet \r
4 \r
5 \r
6 The rapid pace of DragonFly progress makes print media impractical as a means of following the latest developments. Electronic resources are the best, if not often the only, way stay informed of the latest advances. Since DragonFly is a volunteer effort, the user community itself also generally serves as a ***technical support department*** of sorts, with electronic mail and USENET news being the most effective way of reaching that community.\r
7 \r
8 The most important points of contact with the DragonFly user community are outlined below. If you are aware of other resources not mentioned here, please send them to the [DragonFly Documentation project mailing list](http://leaf.dragonflybsd.org/mailarchive/) so that they may also be included.\r
9 \r
10 ## Mailing Lists \r
11 \r
12 Though many of the DragonFly development members read USENET, we cannot always guarantee that we will get to your questions in a timely fashion (or at all) if you post them only to one of the `comp.unix.bsd.*` groups. By addressing your questions to the appropriate mailing list you will reach both us and a concentrated DragonFly audience, invariably assuring a better (or at least faster) response.\r
13 \r
14 The charters for the various lists are given at the bottom of this document. ***Please read the charter before joining or sending mail to any list***. Most of our list subscribers now receive many hundreds of DragonFly related messages every day, and by setting down charters and rules for proper use we are striving to keep the signal-to-noise ratio of the lists high. To do less would see the mailing lists ultimately fail as an effective communications medium for the project.\r
15 \r
16 Archives are kept for all of the mailing lists and can be searched using the [mail archives](http://leaf.dragonflybsd.org/mailarchive/). The keyword searchable archive offers an excellent way of finding answers to frequently asked questions and should be consulted before posting a question.\r
17 \r
18 ### List Summary \r
19 \r
20 ***General lists:*** The following are general lists which anyone is free (and encouraged) to join:\r
21 \r
22 [[!table  data="""
23 | List | Purpose 
24  [bugs](http://leaf.dragonflybsd.org/mailarchive/) | Bug reports 
25  [commits](http://leaf.dragonflybsd.org/mailarchive/) | Messages generated by code changes to DragonFly source, documentation, or the website. 
26  [docs](http://leaf.dragonflybsd.org/mailarchive/) | Discussion of DragonFly documentation 
27  [kernel](http://leaf.dragonflybsd.org/mailarchive/) | Ostensibly for discussion of kernel work, though this list also serves as a catch-all for any topic pertaining to DragonFly. 
28  [submit](http://leaf.dragonflybsd.org/mailarchive/) | Submission and discussion of new code or ideas for DragonFly. 
29  [Test](http://leaf.dragonflybsd.org/mailarchive/) | For testing your newsreader or mail software. 
30  [users](http://leaf.dragonflybsd.org/mailarchive/) | User related discussion about DragonFly. |\r
31 """]]\r
32 ### How to Subscribe \r
33 \r
34 To subscribe to a list, click on the list name above or send an email to <`listname`-request@dragonflybsd.org> and put 'subscribe' in the body of the message.\r
35 \r
36 To actually post to a given list you simply send mail to <`listname`@dragonflybsd.org>. It will then be redistributed to mailing list members world-wide.\r
37 \r
38 To unsubscribe yourself from a list, email <`listname`-request@dragonflybsd.org> and put 'unsubscribe' in the body of the message.\r
39 \r
40 ### List Charters \r
41 \r
42 ***All*** DragonFly mailing lists have certain basic rules which must be adhered to by anyone using them. Failure to comply with these guidelines may result in from all DragonFly mailing lists and filtered from further posting to them. We regret that such rules and measures are necessary at all, but today's Internet is a pretty harsh environment, it would seem, and many fail to appreciate just how fragile some of its mechanisms are.\r
43 \r
44 Rules of the road:\r
45 \r
46
47 * The topic of any posting should adhere to the basic charter of the list it is posted to, e.g. if the list is about technical issues then your posting should contain technical discussion. Ongoing irrelevant chatter or flaming only detracts from the value of the mailing list for everyone on it and will not be tolerated.\r
48
49 * No posting should be made to more than two mailing lists, and only to two when a clear and obvious need to post to both lists exists. For most lists, there is already a great deal of subscriber overlap. If a message is sent to you in such a way that multiple mailing lists appear on the `Cc` line then the `Cc` line should also be trimmed before sending it out again. ***You are still responsible for your own cross-postings, no matter who the originator might have been.***\r
50
51 * Personal attacks and profanity (in the context of an argument) are not allowed, and that includes users and developers alike. Gross breaches of netiquette, like excerpting or reposting private mail when permission to do so was not and would not be forthcoming, are frowned upon but not specifically enforced. ***However***, there are also very few cases where such content would fit within the charter of a list and it would therefore probably rate a warning (or ban) on that basis alone.\r
52
53 * Advertising of non-DragonFly related products or services is strictly prohibited and will result in an immediate ban if it is clear that the offender is advertising by spam.\r
54 \r
55 ### C.1.4 Filtering on the Mailing Lists \r
56 \r
57 The DragonFly mailing lists are filtered in multiple ways to avoid the distribution of spam, viruses, and other unwanted emails. The filtering actions described in this section do not include all those used to protect the mailing lists.\r
58 \r
59 Only certain types of attachments are allowed on the mailing lists. All attachments with a MIME content type not found in the list below will be stripped before an email is distributed on the mailing lists.\r
60 \r
61
62 * application/octet-stream\r
63
64 * application/pdf\r
65
66 * application/pgp-signature\r
67
68 * application/x-pkcs7-signature\r
69
70 * message/rfc822\r
71
72 * multipart/alternative\r
73
74 * multipart/related\r
75
76 * multipart/signed\r
77
78 * text/html\r
79
80 * text/plain\r
81
82 * text/x-diff\r
83
84 * text/x-patch\r
85 \r
86  **Note:** Some of the mailing lists might allow attachments of other MIME content types, but the above list should be applicable for most of the mailing lists.\r
87 \r
88 If an email contains both an HTML and a plain text version, the HTML version will be removed. If an email contains only an HTML version, it will be converted to plain text.\r
89 \r
90 \r
91 \r
92 CategoryHandbook\r
93 Category\r