The sources for this guide are kept in a Git repository on GitHub. If you spot any error or outdated information, you are encouraged to submit a pull request following the steps outlined below.
$git clone https://github.com/macports/macports-guide.git$cd macports-guide$git remote addusernamehttps://github.com/username/macports-guide.git
Install the required ports:
$sudo port install libxslt docbook-xsl
For each change you want to make:
Make your changes to the file in the
guide/xml/ directory that corresponds to the
section you want to make changes to.
$$EDITOR guide/xml/guide.xml
Verify your changes are still valid XML. If the make validate command reports errors, fix the XML sources until you see no more error messages
$make validate
Convert the guide to HTML and view the new version in your browser.
$make guide$open guide/html/index.html
Commit your changes to the local branch and describe your changes in the commit message. See also our wiki page CommitMessages that explains how to write good commit messages.
$git commit -a