<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Hello, MacPorts folks:</p>
<p>Is there a protocol for making improvements to wiki pages at
trac.macports.org beyond, "log in, press the edit button, and make
the change"? I have a documentation improvement that will make my
life easier, but I don't want to make a mess that someone needs to
unwind.</p>
<p>What I want to document is use of links of the form, <br>
</p>
<pre>[changeset:bd5d6800828a3dcda1b65f3999fa748a365b168e/macports-ports] and
[changeset:bd5d6800828a3dcda1b65f3999fa748a365b168e/macports-ports link text here] .
</pre>
<p>These are apparently preferred over links of the form: <br>
</p>
<pre>[<a class="moz-txt-link-freetext" href="https://github.com/macports/macports-ports/commit/bd5d6800828a3dcda1b65f3999fa748a365b168e">https://github.com/macports/macports-ports/commit/bd5d6800828a3dcda1b65f3999fa748a365b168e</a>] and
[<a class="moz-txt-link-freetext" href="https://github.com/macports/macports-ports/commit/bd5d6800828a3dcda1b65f3999fa748a365b168e">https://github.com/macports/macports-ports/commit/bd5d6800828a3dcda1b65f3999fa748a365b168e</a> link text here] .
</pre>
<p>I would like to see this mentioned as examples at
<a class="moz-txt-link-rfc2396E" href="https://trac.macports.org/wiki/WikiFormatting"><https://trac.macports.org/wiki/WikiFormatting></a> and at
<a class="moz-txt-link-rfc2396E" href="https://trac.macports.org/wiki/WikiFormatting#TracLinks"><https://trac.macports.org/wiki/WikiFormatting#TracLinks></a>
and at <a class="moz-txt-link-rfc2396E" href="https://trac.macports.org/wiki/TracLinks"><https://trac.macports.org/wiki/TracLinks></a>. What will
help me is mention of "GitHub commits" as well as "changesets". <br>
</p>
<p>My underlying problem is that I file bug reports with just enough
diligence to want to link to supporting information, and just
often enough to remember that there is a right way to do it, but
not often enough to remember what that right way is.</p>
<p>If I don't hear objections, I'll go ahead and use the edit button
on those pages, and trust that the wiki mechanisms will protect
the content from too much of my damage.</p>
<p>My thanks to everyone who maintains this machinery, and to the
maintainers who swoop in and fix the things I file tickets about.
I appreciate your work.<br>
</p>
<p> —Jim DeLaHunt<br>
</p>
P.S. maybe I should add a HOWTO <<a moz-do-not-send="true"
href="https://trac.macports.org/wiki/howto">https://trac.macports.org/wiki/howto</a>>
encouraging contributions to the wiki?<br>
</body>
</html>