Changeset 28303 for trunk/www/help.php


Ignore:
Timestamp:
Aug 28, 2007, 1:00:46 AM (13 years ago)
Author:
jmpp@…
Message:

Major but minor commit to the www svn space: reorder the sources a bit to have a cleaner
layout while bringing the content up to speed with current practices and reality, otherwise
sticking to the same website we had back in OpenDarwin days.

The one big thing about this commit, though, is that the old ports.php page is again operational,
as shown in my local server: http://apollo.homeunix.net/macports/ports.php. Woot!

Further discussion of what to do with these sources is needed, however, so I'm not gonna push to
host them anywhere for the time being until we have a clearer map of how we should move forward
wrt our web presence.

File:
1 copied

Legend:

Unmodified
Added
Removed
  • trunk/www/help.php

    r28240 r28303  
    11  <?php
    22    $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
    3     include_once("$DOCUMENT_ROOT/includes/common.inc");
    4     /* include_once("$DOCUMENT_ROOT/includes/functions.inc"); */
    5     print_header('Get Help', 'iso-8859-1');
     3    include_once("$DOCUMENT_ROOT/macports/includes/common.inc");
     4    print_header('Get Help', 'utf-8');
    65  ?>
    76
     
    98                <h2 class="hdr">Get Help</h2>
    109
    11                 <p>If you get stuck while using DarwinPorts and have a problem you
    12                         can't figure out, we have a lot of resources to help you.</p>
     10                <p>If you get stuck while using MacPorts and have a problem you
     11                can't figure out, we have a lot of resources to help you.</p>
    1312         
    1413                <h5 class="subhdr">Documentation</h5>
    1514
    16                 <p>The <a href="/docs/">DarwinPorts Guide</a> has a section for DarwinPorts users,
    17                 <a href="http://www.darwinports.org/docs/pt01.html">Part 1: Using DarwinPorts</a>.</p>
     15                <p>The <a href="http://geeklair.net/new_macports_guide/">MacPorts Guide</a> has a section dedicated to MacPorts
     16                installation issues, <a href="http://geeklair.net/new_macports_guide/#installing">Chapter 2. Installing MacPorts</a>
     17                and another one for general usage, <a href="http://geeklair.net/new_macports_guide/#using">Chapter 3: Using MacPorts</a>.</p>
    1818
    19                 <p>The <a href="http://wiki.opendarwin.org/index.php/DarwinPorts:FAQ">DarwinPorts FAQ</a>
    20                 is now an ongoing, user driven effort part of our <a href="http://wiki.opendarwin.org/index.php/DarwinPorts">Wiki</a>,
    21                 where anyone with a <a href="http://wiki.opendarwin.org/index.php?title=Special:Userlogin&returnto=DarwinPorts">Wiki account</a>
    22                 and DarwinPorts knowledge can contribute with information to help others.</p>
     19                <p>The <a href="http://trac.macports.org/projects/macports/wiki/FAQ">MacPorts FAQ</a>
     20                is now an ongoing, user driven effort part of our <a href="http://trac.macports.org/projects/macports/wiki">Wiki</a>,
     21                where anyone with a <a href="http://www.macports.org/wp-register.php">Trac account</a>
     22                and MacPorts knowledge can contribute with information to help others.</p>
    2323
    24                 <p>All of our documentation is a work in progress, so if you spot
    25                         an error, or have a quesiton about some part of the document,
    26                         let us know!  This will help us </p>
     24                <p>All of our documentation is a work in progress, so if you spot an error or have a quesiton about some part of the document,
     25                let us know!  This will help us </p>
    2726       
    2827                <h5 class="subhdr">Mailing Lists</h5>
    2928
    30                 <p>The 
    31                         <a href="http://www.opendarwin.org/mailman/listinfo/darwinports">General DarwinPorts
    32                         mailing list</a> is open to all.  It is the best place to ask
    33                         questions about DarwinPorts, for new users, developers,
    34                         everyone alike!  It is also where all discussion about
    35                         DarwinPorts itself takes place.  Please note that due to spam problems,
    36                         the DarwinPorts mailing list requires posts from
    37                         non-subscribers to be approved.  It may be better to susbcribe.</p>
     29                <p>The <a href="http://lists.macosforge.org/mailman/listinfo/macports-users">General MacPorts mailing list</a> is open to all
     30                for supscription. It is the best place for existing and new users alike to ask questions about MacPorts and MacPorts
     31                installed software. Please note that due to spam problems the mailing list will reject posts from non-subscribers.</p>
    3832
    39                 <p>Although not strictly a requirement, you may check the
    40                         <a href="http://www.opendarwin.org/pipermail/darwinports/">list archives</a>
    41                         before posting a question. We try to be as helpful as possible, but
    42                         if it's a common question our answers may be fairly short.</p>
     33                <p>It is recommended to check the <a href="http://lists.macosforge.org/pipermail/macports-users/">list archive</a> before posting
     34                a question, as some issues are aired fairly regularly and dealt with many times in a row. We try to be as helpful as possible,
     35                but if it's a common question our answers may be fairly short.</p>
    4336
    44                 <p>Otherwise, indexed archives of this list are easily browsable at
    45                         <a href="http://gmane.org/">Gmane.org</a> as well as through
    46                         <a href="nntp://news.gmane.org/">NNTP</a>.</p>
     37                <p>When posting a question to the mailing list, please included any information you think might be relevent to the problem,
     38                such as  operating system and version you're using, Mac OS X 10.4.10 for example, whether you have any other third party
     39                software installed, in <kbd>/usr/local</kbd> for instance, and any error messages that MacPorts might give you (use the
     40                <kbd>-v</kbd> or <kbd>-d port(1)</kbd>'s flags to turn on verbose or debugging information, it's a lot easier for us to
     41                help you once these are used).</p>
    4742
    48                 <p>When you post a question to the mailing list, please included
    49                         any information you think might be relevent to the problem,
    50                         such as what operating system and version you're using, Mac OS X
    51                         10.3.2 for example, whether you have any other third party
    52                         software installed, in /usr/local for instance, and any error
    53                         messages that DarwinPorts might give (use the -d and -v port(1)'s
    54                         flags to turn on debugging informations, it's a lot easier for
    55                         us to help you once these are used).</p>
     43                <p>If you are a developer and need help with any part of the MacPorts internals, the <a href="http://lists.macosforge.org/mailman/listinfo/macports-dev">
     44                development list</a> is where you should direct your posts to, as this is where all discussion about MacPorts itself takes place.
     45                <a href="http://lists.macosforge.org/pipermail/macports-dev/">Archives</a> for this mailing list are also available.</p>
    5646
    5747                <h5 class="subhdr">IRC</h5>
    5848
    59                 <p>For more real-time discussion, the #darwinports channel on the <a
    60                         href="http://freenode.net/">Freenode IRC network</a> is generally
    61                         where we hang out.</p>
    62        
    63                 <p>Though it is generally helpful, please keep in mind that no one is
    64                         obligated to help or even answer your question if you join the IRC
    65                         channel.  Do not take it personally, simply ask your question
    66                         on the <a href="http://www.opendarwin.org/mailman/listinfo/darwinports">mailing list</a>
    67                         instead.</p>
     49                <p>For more real-time discussion, the #MacPorts channel on the <a href="http://freenode.net/">Freenode IRC network</a> is generally
     50                where we hang out. Though it is generally helpful, please keep in mind that no one is obligated to help or even answer your question
     51                if you join IRC. Do not take it personally, simply ask your question on the <a href="http://lists.macosforge.org/mailman/listinfo/macports-users">
     52                users</a> or <a href="http://lists.macosforge.org/mailman/listinfo/macports-dev">development</a> mailing lists instead.</p>
    6853
    6954        </div>
Note: See TracChangeset for help on using the changeset viewer.