TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: reviewer process - for HTML "doc" From:Robert Lauriston <robert -at- lauriston -dot- com> To:Monique Semp <monique -dot- semp -at- earthlink -dot- net>, TechWR-L <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 23 May 2014 08:06:34 -0700
Do you have a code review tool like Review Board or Crucible? If not,
could you install Review Board?
Doxygen can output RTF, reviewers could use Word / LibreOffice change markup.
On Thu, May 22, 2014 at 2:56 PM, Monique Semp
<monique -dot- semp -at- earthlink -dot- net> wrote:
> Hello, TechWR-L-ers,
>
> Iâm using Doxygen to generate HTML output for a C++ library. Not all the doc reviewers have direct access to the code that Iâm commenting, so Iâll need to solicit reviews by using the HTML output instead of just having the engineers look at my code check-ins (for the doxygen tags that Iâm adding).
>
> So do you have any recommendations for workflow and for how reviewers can provide input in an easier fashion than saying, âon the blah-blah-blah.html page, third para in the \this-tag, the âold-textâ should be ânew-textâ?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp enhancements, and more. Read all about it.
