[ 
https://issues.apache.org/jira/browse/SOLR-18119?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18058521#comment-18058521
 ] 

Chris M. Hostetter commented on SOLR-18119:
-------------------------------------------

Example of what this looks like overall...

 
{noformat}
...

> Task :solr:documentation:changesToHtml
WARNING: Python is not installed, skipping creating Changes.html

...

> Task :solr:solr-ref-guide:checkSiteLinks FAILED
{
  "stats": {
    "errors": [
      {
        "type": "page",
        "target": 
"..\\..\\..\\documentation\\build\\site\\changes\\Changes.html",
        "source": "solr\\latest\\upgrade-notes\\solr-upgrade-notes.html",
        "reason": "page not found"
      }
    ],
    "warnings": [],
    "parsedFiles": 822,
    "localLinks": 234,
    "localAnchorLinks": 3212,
    "parentLinks": 199,
    "parentAnchorLinks": 5,
    "remoteLinks": 0,
    "remoteAnchorLinks": 0
  }
}


> Task :solr:documentation:checkBrokenLinks FAILED
Broken links check failed. First lines of the output:

Crawl/parse...

Verify...

file:///C%3A/Users/jenkins/workspace/Solr-main-Windows/solr/documentation/build/site/index.html
  BROKEN LINK: 
file:///C%3A/Users/jenkins/workspace/Solr-main-Windows/solr/documentation/build/site/changes/Changes.html

...

{noformat}


> Changes.html generation is quietly skipped if python3 not found, can cause 
> downstream tasks to fail confusingly 
> ----------------------------------------------------------------------------------------------------------------
>
>                 Key: SOLR-18119
>                 URL: https://issues.apache.org/jira/browse/SOLR-18119
>             Project: Solr
>          Issue Type: Bug
>            Reporter: Chris M. Hostetter
>            Priority: Major
>
> ChangesToHtmlTask will log a warning if python3 doesn't exist – but it does 
> not fail.
> downstream tasks that (implicitly) depend on the existence of Changes.html 
> will subsequently fail...
>  
> {noformat}
> :solr:documentation:checkBrokenLinks
> :solr:solr-ref-guide:checkSiteLinks{noformat}
>  
> This can be very confusing on jenkins boxes – such as our Windows jenkins 
> build, which does not have python3 – when people don't know/realize that 
> {{:solr:documentation:changesToHtml}} quietly did nothing.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to