Documentation testing and textproc/igor

[Warren Block]

On Tue, 25 Nov 2014, Li-Wen Hsu wrote:

> On Sun, Nov 23, 2014 at 16:58:30 -0700, Warren Block wrote:
>> As far as I know, igor checkstyle output works now.  I would like to
>> expand on that later, but it can wait for the basic Jenkins doc test to
>> be completed.
>
> If I understand this paragraph correctly, you want to have a basic
> jenkins doc test (checking if building is fine), which does exist:
>
>    https://jenkins.freebsd.org/jenkins/job/FreeBSD_DOC/
>
> and this jobs sends mail to freebsd-doc@ list.
>
> FreeBSD_Doc-igor job does a bit more, as a "downstream" job for
> FreeBSD_DOC, after each FreeBSD_DOC job finished successfully, it
> launches igor and check if the doc files are well-written. Then
> maintains a graph for tracking the "bad smell" counter.
>
> Do you guys think it's time to send those "updates" to freebsd-doc@
> list?  I thought it can send mail such as ""
>
>   Checkstyle: 190 warnings from one analysis.
>   17 new warnings
>   13 fixed warnings
>
> Just like we see in:
>
>    https://jenkins.freebsd.org/jenkins/job/FreeBSD_Doc-igor/20/
>
> I would try if this can be done by job configuration.

For now, how about we announce the FreeBSD_Doc-igor page on doc@ and and 
ask for feedback?