Currently there are **180** warnings:
- more than one target found for cross-reference (157): we should be more specific in `@type param: Page` and similar, partially #Upstream as some of these should prefer local file method over another file's
- invalid signature for automethod (5 in page_tests and plural_tests): {nav name=possibly upstream}
- don't know which module to import for autodocumenting (same 5): {nav name=possibly upstream}
- Literal block expected; none found (4 in category, patrol and welcome): ":" before paragraph, not before indented text. It is processed to "::" by conf.py, therefore throws these warnings
- Inline substitution_reference start-string without end-string (3 in archivebot_tests and api): somehow the fix in conf.py doesn't affect these two even if it is moved before script and module conditions {nav name=possibly upstream}
- Definition list ends without a blank line (2 in weblinkchecker): this is weird as it is indented and still it produces these errors {nav name=possibly upstream}
- Block quote ends without a blank line (1 in featured): no idea {nav name=possibly upstream}
- test command found but not installed in testenv (1): from testenv
- Site objects have been created before arguments were handled (1 in bot.py): from testenv
These warnings and errors make doc builds for the issued scripts completely failing (therefore missing in docs):
- {T192706}: build skips it successfully
- API error invalidtitle: Bad title "Category::-M": failed to import makecat.py. This is somehow linked also to the warning in bot.py above and below.
- script_wui.py, userinterfaces/gui.py: build skips it successfully
- failed to import module (lua in script_wui.py, _tkinter in userinterfaces/gui.py and makecat in bot.py): probably not possible to solve
Errors and warnings can be easily tested on:
- [[http://rst.ninjs.org/#|reST]]
- [[https://livesphinx.herokuapp.com/|Sphinx]]
- none found for epytext yet, the two above should do
Note: Don't forget to process raw docstring to " -" and "::" before pasting to the editors above, see docs/conf.py for more details
Below is somewhat last whole documentation build with all the remaining warnings:
{P6679, lines=10}
Below fixed in T192255:
~~As pointed out in T185082, the build throws thousands of warnings about nonexistent linkage. See e.g. the last build: https://integration.wikimedia.org/ci/job/pywikibot-core-tox-doc-docker/1085/consoleText. It looks like there are some relative path issues. The vast majority of docs builds successfully, so these might be only minor issues.~~
~~In the example above you can see thousands of nonexisting and unknown linkage warnings.~~
~~93 000 warnings found in total.~~
Below fixed in T192356 and T192357:
- ~~{T192357}: produces build error, therefore completely suppressed~~
- ~~{T192356}: produces build error, therefore completely suppressed~~