X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/9b9db4f8a7ad4b4337d2b0acbd5ce7e46c2b763b..4843d460e752968f8643f0bfe76dd904ca52cbae:/doc/tips/issue_tracking.mdwn diff --git a/doc/tips/issue_tracking.mdwn b/doc/tips/issue_tracking.mdwn index 20866f0de..a39b93656 100644 --- a/doc/tips/issue_tracking.mdwn +++ b/doc/tips/issue_tracking.mdwn @@ -3,8 +3,9 @@ By Joey Hess, LinuxWorld.com [[template id=note text=""" -First published on [LinuxWorld.com](http:://www.linuxworld.com/), a -publication of Network World Inc., 118 Turnpike Rd., Southboro, MA 01772. +[First published](http://www.linuxworld.com/news/2007/040607-integrated-issue-tracking-ikiwiki.html) +on [LinuxWorld.com](http:://www.linuxworld.com/), a publication of Network +World Inc., 118 Turnpike Rd., Southboro, MA 01772. """]] Wikis are not just for encyclopedias and websites anymore. You can use @@ -18,7 +19,7 @@ described by the term "wiki compiler". Just as a typical software project consists of source code that is stored in revision control and compiled with `make` and `gcc`, an ikiwiki-based wiki is stored as -human editable source in a revision control system, +human-editable source in a revision control system, and built into HTML using ikiwiki. Ikiwiki uses your revision control system to track @@ -34,13 +35,13 @@ In the rare cases where automatic merging fails because of concurrent edits to the same part of a page, regular commit conflict markers are shown in the file to let you resolve the conflict, as you -would for conflicting edit in source code. +would for conflicting edits in source code. Ikiwiki is a full-featured wiki that you can use for a variety of purposes, from traditional wikis to weblogs, podcasting, or even aggregating other sites' RSS feeds into a Planet page. While people -are [[using|ikiwikiusers.html]] +are [[using|ikiwikiusers]] Ikiwiki for purposes ranging from genealogy research to shoe accessory sales, one thing it's especially well suited for is collaborative software development, @@ -54,7 +55,8 @@ The simplest way to use ikiwiki is to build static HTML files from source wiki files. This example builds a wiki for an imaginary software project. The wiki source files used in this example are available in the -[[examples/softwaresite]] section of ikiwiki's documentation. +[[examples/softwaresite|examples/softwaresite]] section +of ikiwiki's documentation. wiki$ ls Makefile bugs.mdwn doc/ download.mdwn news/ @@ -91,7 +93,7 @@ project's website. You can check the wiki-format text into revision control as part of the software project, and tie it into the build system using the Makefile. -Ikiwiki can also be tied into the `post-commit` hook of your revision +Ikiwiki can also be tied into the [[post-commit]] hook of your revision control system, so that whenever a developer commits a change to a wiki page in revision control, the project's web site is automatically updated. The [[ikiwiki_tutorial|setup]] explains in @@ -128,8 +130,8 @@ While directories are useful for broad hierarchical grouping, tags are better for categorizing issues as bugs, wishlist items, security issues, patches, or whatever other categories are useful. Bugs can -be tagged "moreinfo", "done" "unreproducible", -or "moreinfo", etc, to document different stages of +be tagged "moreinfo", "done", "unreproducible", +etc, to document different stages of their lifecycle. A developer can take ownership of a bug by tagging it with something like "owner/Joey".