New guide section on Git and GitHub

Perry E. Metzger pmetzger at macports.org
Thu Apr 12 15:35:48 UTC 2018


On Wed, 11 Apr 2018 19:30:56 -0400 Andrew Moore <slewsys at gmail.com>
wrote:
> As someone who only reads the manual as last resort, I think
> Section 7 of the MacPorts Guide could be retitled from “MacPorts
> Project” to “Contributing to MacPorts”.  And then steps for
> creating pull requests via GitHub spelled out tutorial-wise.
> Perhaps steal an existing tutorial
> <https://yangsu.github.io/pull-request-tutorial/>.

Pull requests to make these changes would be quite welcome!

> While I appreciate the intent, I think “easing into” GitHub is more
> obfuscating, and actually adds an extra hurdle for contributors.
> For instance the section immediately following “Using Git and
> GitHub” is titled “New Ports” and proceeds with steps for
> contributing a Trac ticket.

Only after saying please use GitHub preferentially in boldface and
first saying "use github! but if you're using trac, do this!"

Perry
-- 
Perry E. Metzger		pmetzger at macports.org


More information about the macports-dev mailing list