Re: [PATCH] docs/devel/testing.rst: Update outdated Avocado URLs

[John Snow]

On 2/8/21 7:59 AM, Philippe Mathieu-Daudé wrote:
> On Fri, Feb 5, 2021 at 12:53 AM John Snow <jsnow@redhat.com> wrote:
> > On 10/10/20 4:07 AM, Philippe Mathieu-Daudé wrote:
> > > Avocado documentation referred returns 404 error.
> > > Update the broken links.
> > >
> > > Signed-off-by: Philippe Mathieu-Daudé <philmd@redhat.com>
> > > ---
> > >    docs/devel/testing.rst | 4 ++--
> > >    1 file changed, 2 insertions(+), 2 deletions(-)
> > >
> > > diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
> > > index bd64c1bdcdd..23a1697d9f4 100644
> > > --- a/docs/devel/testing.rst
> > > +++ b/docs/devel/testing.rst
> > > @@ -696,7 +696,7 @@ To manually install Avocado and its dependencies, run:
> > >
> > >    Alternatively, follow the instructions on this link:
> > >
> > > -  
> > > http://avocado-framework.readthedocs.io/en/latest/GetStartedGuide.html#installing-avocado
> > > +  
> > > https://avocado-framework.readthedocs.io/en/latest/guides/user/chapters/installing.html
> > >
> > >    Overview
> > >    --------
> > > @@ -879,7 +879,7 @@ Parameter reference
> > >    To understand how Avocado parameters are accessed by tests, and how
> > >    they can be passed to tests, please refer to::
> > >
> > > -  
> > > http://avocado-framework.readthedocs.io/en/latest/WritingTests.html#accessing-test-parameters
> > > +  
> > > https://avocado-framework.readthedocs.io/en/latest/guides/writer/chapters/writing.html#accessing-test-parameters
> > >
> > >    Parameter values can be easily seen in the log files, and will look
> > >    like the following:
> >
> > Do you know if there's a way we can augment sphinx to check link status
> > once in a while?
>
> No, but good idea! Why not ask on the list, IIRC danpb mentioned something
> similar in another thread.
>
> > If there's a callback where we can get sphinx to call a python function
> > for every URL it finds, we can use response = requests.head(url) and
> > check response.status_code to make sure it's 200 OK.

OK, at Phil's nudge: Does anyone know if there's a Sphinx callback for 
URL processing? We could probably write a test that we could enable 
every-so-often.

I am thinking there might be some benefit to a test suite that we only 
run once-in-a-while during release candidate phases, and this could be 
one of them.

> > --js