`make html` warnings about omero-guides HOT 3 OPEN

@pwalczysko : 👍 for the PRs. Do you expect there to be no warnings at the moment? If so, shall we make warnings errors in the GHA builds?

from omero-guides.

Do you expect there to be no warnings at the moment?

No. One of the warnings is because of the relative path to a file.

upload/docs/import-cli.rst:47: WARNING: download file not readable: /Users/pwalczysko/Work/scripts/bulk.yml

this warning is produced when the make html is run locally from the top level repo (omero-guides) but the file is fine on https://omero-guides.readthedocs.io/projects/upload/en/latest/import-cli.html?highlight=bulk.yml#bulk-import-using-the-cli - you can download https://omero-guides.readthedocs.io/projects/upload/en/latest/_downloads/904615f9c13e025de80ada2f34b1d5ae/bulk.yml as expected.

The rest should nevertheless be clear - the only confusion I have is that I did not see some of the warns you reported.

from omero-guides.

shall we make warnings errors in the GHA builds

this would make sense but depending on your judgement Re relative filepaths as indicated in #56 (comment) - atm I am deeming it a "must live with that warning because no better idea and principally it works", but open to suggestions

from omero-guides.