Re: Proposal: Remove "Installation" Wiki section

[Zach Hoffman <zr...@apache.org>]

> Since these are already covered by existing documentation, IMO, we can
just
get rid of this section without needing to transfer it.

Agreed that we don't need to copy it to the wiki, but IMO this page should
link to the relevant section of our documentation instead of being deleted.


On Tue, Aug 31, 2021 at 4:17 PM ocket 8888 <oc...@gmail.com> wrote:

> This section has a single sub-heading:
> Installation Gotchas
>
>    - Criteria for the first-time snapshot is not clear. We should clearly
>    state what is required (edge, mid, DS)
>    - Servers are set to ONLINE Instead of REPORTED leads to health checks
>    not working
>
>
> The meaning of the "criteria for the first-time snapshot is not clear" is
> unclear to me - is it saying we should document the minimum required
> configuration of ATC objects that must exist for a CDN to serve content
> successfully? I would argue that through the docs' "CDN Basics" and
> "Overview" sections and by defining what a Delivery Service and a Cache
> Server are, we have already accomplished that.
>
> Likewise "Servers are set to ONLINE Instead of REPORTED leads to health
> checks not working" seems to be already covered by the definitions of
> ONLINE and REPORTED in the official documentation; ONLINE ignores health
> checks by design.
>
> Since these are already covered by existing documentation, IMO, we can just
> get rid of this section without needing to transfer it.
>

Re: Proposal: Remove "Installation" Wiki section

[ocket 8888 <oc...@gmail.com>]

The page is now a redirect to
https://traffic-control-cdn.readthedocs.io/en/latest/admin/index.html

On Tue, Aug 31, 2021 at 7:44 PM Zach Hoffman <zr...@apache.org> wrote:

> > Since these are already covered by existing documentation, IMO, we can
> just
> get rid of this section without needing to transfer it.
>
> Agreed that we don't need to copy it to the wiki, but IMO this page should
> link to the relevant section of our documentation instead of being deleted.
>
>
> On Tue, Aug 31, 2021 at 4:17 PM ocket 8888 <oc...@gmail.com> wrote:
>
> > This section has a single sub-heading:
> > Installation Gotchas
> >
> >    - Criteria for the first-time snapshot is not clear. We should clearly
> >    state what is required (edge, mid, DS)
> >    - Servers are set to ONLINE Instead of REPORTED leads to health checks
> >    not working
> >
> >
> > The meaning of the "criteria for the first-time snapshot is not clear" is
> > unclear to me - is it saying we should document the minimum required
> > configuration of ATC objects that must exist for a CDN to serve content
> > successfully? I would argue that through the docs' "CDN Basics" and
> > "Overview" sections and by defining what a Delivery Service and a Cache
> > Server are, we have already accomplished that.
> >
> > Likewise "Servers are set to ONLINE Instead of REPORTED leads to health
> > checks not working" seems to be already covered by the definitions of
> > ONLINE and REPORTED in the official documentation; ONLINE ignores health
> > checks by design.
> >
> > Since these are already covered by existing documentation, IMO, we can
> just
> > get rid of this section without needing to transfer it.
> >
>