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

James Peach commented on TS-764:
--------------------------------

Although, the man pages are currently skeletons, and none of the docs are 
actually *shipped* with the product (ie. not installed) ...
                
> Traffic Server does not ship any documentation 
> -----------------------------------------------
>
>                 Key: TS-764
>                 URL: https://issues.apache.org/jira/browse/TS-764
>             Project: Traffic Server
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 2.1.8
>            Reporter: Arno Toell
>
> A major problem for ATS to the unskilled user as of today is, there is no 
> on-line documentation besides the (somewhat  scarce) information from the 
> home page is available. In particular ATS misses
> * first of all: man pages 
> * Description of command line switches (if any), including an interactive 
> help, e.g. the common _"-h/--help"_ switch.
> * Description of the used environment, e.g. _$TS_ROOT_ where applicable. 
> I think this would be an important release goal for the 3.0 release since 
> that branch is intended for productive use, not by developers. If someone 
> provides me the information or has all needed information in a written form, 
> I could assist to provide man pages. 
> I'm aware there is some documentation for _traffic_shell_ commands. I'm 
> unsure if the documentation there reflects the most recent development and is 
> generally up to date. If it is still suitable for ATS as of today, it should 
> be merged with any newly created documentation. As a remark: I remember there 
> was some discussion in the past, where to install the man pages because of 
> the rather generic names, for example "enable", "disable", "exit", ...

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to