[jira] [Commented] (TS-764) Traffic Server does not ship any documentation

["James Peach (JIRA)" <ji...@apache.org>]

    [ 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