Skip to content

[MAINT] test build all test docs in strict mode#340

Open
Remi-Gau wants to merge 5 commits intosphinx-contrib:masterfrom
Remi-Gau:doc/fail_on_warning
Open

[MAINT] test build all test docs in strict mode#340
Remi-Gau wants to merge 5 commits intosphinx-contrib:masterfrom
Remi-Gau:doc/fail_on_warning

Conversation

@Remi-Gau
Copy link
Copy Markdown
Collaborator

Ideally we want to avoid build warnings in our test doc

  • set all doc builds in the tests folder to run in strict mode (fail on warning) if run via make
  • ignore some of the warnings and try to comment why
  • test run all those doc builds in CI

classdef Domain
% Describes a set of elements with a common structure
%
% Those elements can be compared (`.eqv`), and random elements can be produced (`.sample`).
Copy link
Copy Markdown
Collaborator Author

@Remi-Gau Remi-Gau Jan 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this needs to be removed to avoid a warning about a missing ref

% BaseClass Methods:
% BaseClass - the constructor, whose description extends
% to the next line
%
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixes a doc build warning

Comment thread tests/test_autodoc.py
"BaseClass Methods:\n"
"* :meth:`BaseClass() <BaseClass.BaseClass>` - the constructor, whose description extends\n"
" to the next line\n\n"
"DoBase - another BaseClass method\n"
Copy link
Copy Markdown
Collaborator Author

@Remi-Gau Remi-Gau Jan 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed to change this test after modifying BaseClass (see https://github.com/sphinx-contrib/matlabdomain/pull/340/files#r2680058113)

but I am a bit surprised that just adding an extra line changes:

"* :meth:`DoBase() <BaseClass.DoBase>` - another BaseClass method\n"

to

"DoBase - another BaseClass method\n"

"BaseClass Methods:\n"
"* :meth:`BaseClass() <BaseClass.BaseClass>` - the constructor, whose description extends\n"
" to the next line\n\n"
"DoBase - another BaseClass method\n"
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as above

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant