source: trunk/www/contact.php @ 36578

Last change on this file since 36578 was 36578, checked in by ryandesign@…, 12 years ago

contact.php: fix the smart quotes

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
  • Property svn:mime-type set to text/x-php
File size: 9.6 KB
Line 
1<?php
2    /* -*- coding: utf-8; mode: php; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=utf-8:filetype=php:et:sw=4:ts=4:sts=4 */
3    /* $Id: contact.php 36578 2008-05-07 07:38:17Z ryandesign@macports.org $ */
4    /* Copyright (c) 2007, The MacPorts Project. */
5    $MPWEB = $_SERVER['DOCUMENT_ROOT'] . dirname($_SERVER['SCRIPT_NAME']);
6    include_once("$MPWEB/includes/common.inc");
7    print_header('The MacPorts Project -- Contact Us', 'utf-8');
8?>
9
10
11<div id="content">
12
13    <h2 class="hdr">Getting in Touch With Us</h2>
14
15    <p>There are a number of ways in which you can get in contact with people involved with The MacPorts Project, depending
16    on who you need to contact and the type of support and/or feedback you're looking for:</p>
17
18    <ul>
19        <li><a href="#Lists">Public Mailing Lists</a></li>
20        <li><a href="#PortMgr">Administrative Contact</a></li>
21        <li><a href="#Tracker">Bug Reports &amp; Contributions</a></li>
22        <li><a href="#IRC">IRC</a></li>
23        <li><a href="#Individuals">Individuals</a></li>
24    </ul>
25
26
27    <h3>Getting Help</h3>
28
29    <p>If you're looking for help to troubleshoot a particular failure installing or using MacPorts, providing us with as
30    much information about your host platform as you can gather will help us help you in turn to look into the problem.
31    The following simple steps comprise our recommended procedure to obtain support:</p>
32
33    <ol>
34        <li>First and foremost, check the MacPorts <a href="<?php print $guide_url; ?>">Documentation</a>, man pages, <a
35        href="<?php print $trac_url . 'wiki/FAQ'; ?>">FAQ</a> and <a href="<?php print $trac_url . 'wiki/ProblemHotlist';
36        ?>">problems hotlist</a>.</li>
37        <li>Second, check the archives of the appropriate mailing list you intend to post to (below) to see if your question
38        has already been asked and dealt with.</li>
39        <li>Finally, if you still haven't found the answer to your problem, send e-mail to the appropriate mailing list
40        with the following information:
41            <ul>
42                <li>output generated by the &#8220;<kbd>port</kbd>&#8221; command's <kbd>-v</kbd> (verbose) or <kbd>-d</kbd>
43                (debug) flags;</li>
44                <li>platform details such as operating system version (e.g. 10.4.10) and hardware architecture (e.g. Intel
45                or PowerPC) -- the &#8220;<kbd>sw_vers</kbd>&#8221; and &#8220;<kbd>uname -a</kbd>&#8221; commands are of
46                great help in this regard;</li>
47                <li>any third party software that may exist in places such as <kbd>/usr/local</kbd> and/or <kbd>/sw</kbd>.
48                </li>
49            </ul>
50        </li>
51    </ol>
52
53
54    <h3 class="subhdr" id="Lists">Public Mailing Lists</h3>
55
56    <p>The MacPorts Project hosts a number of specialized mailing lists you can freely subscribe to:</p>
57
58    <ul>
59        <li><a href="http://lists.macosforge.org/mailman/listinfo/macports-users/">MacPorts Users</a>
60        (<a href="http://lists.macosforge.org/pipermail/macports-users/">archives</a>):
61            <p>General discussion of MacPorts installation and usage. A moderate volume list.</p>
62        </li>
63        <li><a href="http://lists.macosforge.org/mailman/listinfo/macports-dev/">MacPorts Developers</a>
64        (<a href="http://lists.macosforge.org/pipermail/macports-dev/">archives</a>):
65            <p>Where project members and contributors discuss the MacPorts &#8220;base&#8221; system itself and future
66            development plans, and related &#8220;Portfile&#8221; writing best practices. A low volume list.</p>
67        </li>
68        <li><a href="http://lists.macosforge.org/mailman/listinfo/macports-changes/">MacPorts Changes</a>
69        (<a href="http://lists.macosforge.org/pipermail/macports-changes/">archives</a>):
70            <p>Read-only, low to moderate volume list of changes to our <a href="<?php print $svn_url; ?>">SVN repository</a>
71            for both &#8220;base&#8221; code and Portfiles, among others.</p>
72        </li>
73        <li><a href="http://lists.macosforge.org/mailman/listinfo/macports-tickets/">MacPorts Tickets</a>
74        (<a href="http://lists.macosforge.org/pipermail/macports-tickets/">archives</a>):
75            <p>Read-only, moderate volume list of ticket activity on our <a href="<?php print $trac_url; ?>">Trac bug tracker
76            </a>.</p>
77        </li>
78        <li><a href="http://lists.macosforge.org/mailman/listinfo/macports-announce/">MacPorts Announce</a>
79        (<a href="http://lists.macosforge.org/pipermail/macports-announce/">archives</a>):
80            <p>Read-only, low volume list for project related major announcements.</p>
81        </li>
82    </ul>
83
84    <p>Note that due to spam control policies you must subscribe to our non read-only lists in order to post to any of them.
85    Members are expected to abide by the very simple <a href="http://www.dtcc.edu/cs/rfc1855.html">Netiquette guidelines</a>
86    that are common to most open forums when posting; of particular relevance is sticking to plain text messages, our language
87    of choice (English), and reducing the number and size of attachments in any way possible (e.g, by using paste bins such
88    as <a href="http://paste.lisp.org/new/macports">lisppaste</a> or <a href="http://pastie.caboo.se">pastie</a> and
89    passing along the paste URL rather than full error messages).</p>
90
91
92    <h3 class="subhdr" id="PortMgr">Administrative Contact</h3>
93
94    <p>The private and read-only &#8220;<?php print obfuscate_email("macports-mgr@lists.macosforge.org"); ?>&#8221; mailing
95    list is where you should send mail to in case you need to get in touch with the The MacPorts Project's <a href="<?php print
96    $guide_url . '#project.portmgr'; ?>">management team</a> (A.K.A. &#8220;PortMgr&#8221;), in case you have any administrative
97    request or if you wish to discuss anything you might feel is of private nature (like the interaction between MacPorts and
98    NDA'd software).</p>
99
100    <p>This is also where you should turn to if you are a developer and/or a contributor interested in joning The MacPorts
101    Project with full write access to our SVN repository and Wiki pages, either to work on MacPorts itself or as a ports
102    maintainer. Please read the <a href="<?php print $guide_url . '#project.membership'; ?>">documentation available</a>
103    on joining for more information.</p>
104
105
106    <h3 class="subhdr" id="Tracker">Bug Tracker</h3>
107
108    <p>We use the popular <a href="http://trac.edgewall.org/">Trac</a> web-based tool for our <a href="<?php print $trac_url .
109    'roadmap'; ?>">bug tracking</a> and <a href="<?php print $trac_url . 'wiki'; ?>">Wiki</a> needs, thus buying ourselves
110    seamless read-only integration with our SVN repository through its <a href="<?php print $trac_url . 'browser'; ?>">
111    source browser</a> and the project <a href="<?php print $trac_url . 'timeline'; ?>">timeline</a> (where ticket activity
112    can also be viewed). Note that in order to interact with Trac for anything other than read only operations, you need
113    to <a href="http://www.macosforge.org/wp-register.php">register</a> with Mac OS Forge for a Wordpress/Trac combined
114    account.</p>
115
116    <p>If you think you've found a bug either in one of our <a href="ports.php">available ports</a> or in MacPorts itself, or
117    on the other hand if you'd like to make a contribution of any kind to the project, feel free to <a href="<?php print $trac_url
118    . 'newticket'; ?>">open a ticket</a> to help us look into the problem and/or submission. Please keep in mind that we
119    usually get a fairly high number of duplicate reports for common problems and therefore appreciate any help we can get in
120    the process of streamlining our ticket duties. <a href="<?php print $trac_url . 'search'; ?>">Searching</a> the Trac database
121    &amp; mailing list archives (above), and reading our <a href="<?php print $trac_url . 'wiki/FAQ'; ?>">FAQ</a> &amp;
122    <a href="<?php print $trac_url . 'wiki/ProblemHotlist'; ?>">problems hotlist</a> to see if your report has already been filed
123    is recommended, as well as reading the <a href="<?php print $guide_url . '#project.tickets'; ?>"> ticketing guidelines</a>
124    that will help you create a better report.</p>
125
126    <p>Viewing existing tickets through the facilities offered by predefined and custom <a href="<?php print $trac_url .
127    'report'; ?>">ticket reports</a> that allow for detailed queries is also available.</p>
128
129
130    <h3 class="subhdr" id="IRC">IRC</h3>
131
132    <p>For a more real-time discussion of any MacPorts related topic, the <a href="irc://chat.freenode.net/#MacPorts">
133    #MacPorts</a> channel on the <a href="http://freenode.net/">Freenode network</a> is where some of us usually hang out,
134    MacPorts developers and community members alike. Everyone is free and welcomed to join us, even if it is for a random
135    fun conversation or a productive troubleshooting session, but please keep in mind that no one is guaranteed to be
136    around at any particular moment and that channel members are not obligated to answer your questions. If you fail to
137    get any traction at time, do not take it personally and simply direct your questions to the mailing lists instead.</p>
138
139    <p>The language of choice for the IRC channel is also English, for obvious reasons of universality, so sticking to it
140    is appreciated.</p>
141
142
143    <h3 class="subhdr" id="Individuals">Individuals</h3>
144
145    <p>To find out who the people behind MacPorts are and what they are up to, visit the <a href="<?php print $trac_url . 
146    'wiki/MacPortsDevelopers'; ?>">team members page</a> on our Wiki and our <a href="http://cia.vc/stats/project/MacPorts">CIA
147    project page</a>, which also shows SVN commit activity and many other project statistics.</p>
148
149</div>
150
151
152<?php
153    print_footer();
154?>
Note: See TracBrowser for help on using the repository browser.