Karl Richter created TS-3090:
--------------------------------
Summary: docs.trafficserver.apache.org introduces a very high
barrier to get started
Key: TS-3090
URL: https://issues.apache.org/jira/browse/TS-3090
Project: Traffic Server
Issue Type: Improvement
Components: Documentation
Reporter: Karl Richter
Currently the administration guide introduces a unnecessary high barrier to get
started, examples include
* mentioning of default configuration in
https://docs.trafficserver.apache.org/en/latest/admin/getting-started.en.html#start-traffic-server,
but no link to alternative configurations (how to check out caching features?)
* no overview over different modes and their control (it should be clear how
to start a caching proxy after reading the caching proxy section or if not
where to read further)
* Is it necessary to read about all different types of proxying trafficserver
offers or can the reader skip the sections about modes which are not
interesting? Please add a statement.
There are project where the user just can't get started out-of-the-box and that
is perfectly fine - there's nothing better sitting in front of the chimney and
reading a well written manual ;). If this is the case for trafficserver please
add a statement with a short explanation or state that there's no getting
started guide for reason X and Y.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
