Laura Stewart wrote:
For the 10.2 Documentation Review process, a wiki was used to log comments and track the status of those comments. http://wiki.apache.org/db-derby/TenTwoDocReview
[snip]
Was the wiki a good way to conduct the reviews?
I found adding an entry to the wiki was in some ways more painful than entering a Jira issue. The pain was the manual formating of the table and distractions would cause one to lose the edit lock on the wiki page, in one case losing my comments.
Then with the wiki there is no good tracking of how the issue was resolved, no link to the patch number or the Jira entry that fixed it.
So maybe just using Jira is better as it's fairly quick, doesn't lose issues and allows tracking. Might result in a large number of Jira issues but I'm nt sure that's really a problem.
Some direct markup of an html page on the site directly would be much better though. :-) I saw a page with a number of minor mistakes on it the other day, but it seemed a lot of effort to write those up in a Jira entry, namely having to describe the mistake, which document, section, paragraph etc. that it occurs in.
Dan.
