Uploaded image for project: 'VOLTHA'
  1. VOLTHA
  2. VOL-5234

repo:voltha-docs, cleanups and make linkcheck delay (long runtime)

    XMLWordPrintable

    Details

    • Type: Task
    • Status: To Do (View Workflow)
    • Priority: Low
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Documentation
    • Labels:
      None
    • Story Points:
      0

      Description

      repo:voltha-docs

      % make linkcheck

       

      The linkcheck target can take a while to run due to blocking and misc overhead.  Look into delays and see if they can be removed.

      • Rate limiting
        • Plenty of these reported for hub.docker URLs.  Sphinx is simply verifying URL existence VS retrieving content.  Determine if alternate URLs could be used or if we can query differently – seems to be based on [n]pulls per [h]hours.

      https://docs.docker.com/docker-hub/download-rate-limit/

      • Submitting multiple repo:voltha-docs patches on the same day will likely trigger heavy rate limiting given volume of URLs being checked.

       

      URLS: Moved permanently to

      • Web redirects and redirects due to http => http(s) all add lookup overhead for sphinx url checking.  See if URLs can be replaced with the resolved equivalent to decrease per-url lookup overhead.

       

       
      reading sources... [ 73%] overview/operate 
      writing output... [ 73%] overview/operate 
      -rate limited-   https://hub.docker.com/r/voltha/bbsim | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/bbsim-sadis-server | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-ci-tools | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-bbsim | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-cli | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/bbsim-sadis-server | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-afrouter | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-adapter-simulated-onu | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-bbsim | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-protos | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-shovel | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-afrouter | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-adapter-simulated-onu | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-bbsim | sleeping... 
      -rate limited-   https://hub.docker.com/r/voltha/voltha-bbsim | sleeping... 
      

        Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

            Assignee:
            Unassigned
            Reporter:
            joey Joey Armstrong
            Watchers:
            1 Start watching this issue

              Dates

              Created:
              Updated:

                Gerrit Reviews

                There are no open Gerrit changes