[ 
https://issues.apache.org/jira/browse/TS-2783?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14005704#comment-14005704
 ] 

Piotr Buliński commented on TS-2783:
------------------------------------

{code}
I: Entries in total: 491
I: Entries with errors: 430
{code}

It looks like a lot of problems and it doesn't check the defaults hard coded in 
the source (.cc files).
Could we possibly move all the documentation/descriptions from 
*doc/reference/configuration/records.config.en.rst* to *mgmt/RecordsConfig.cc* 
and then generate *records.config.en.rst* and *records.config.default.in* from 
*RecordsConfig.cc*?

> Automated verification of defaults (config vs. code)
> ----------------------------------------------------
>
>                 Key: TS-2783
>                 URL: https://issues.apache.org/jira/browse/TS-2783
>             Project: Traffic Server
>          Issue Type: Improvement
>          Components: Configuration, Documentation
>            Reporter: Piotr Buliński
>            Assignee: Bryan Call
>             Fix For: 5.0.0
>
>
> There are cases where documentation states different defaults than they are 
> actually used in code. I will work on some automated mechanism verifying 
> that, so we can keep easily code and docs in sync with each release.
> Additionally it should show:
>  - missing configuration parameters in docs,
>  - unused configuration parameters in code.



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to