GeezerVison

👍 modulo placating the linter .

I think we should go with adding a # noqa: E501 after the closing """ or exempt this whole file from the line length checks rather than forcing the table to fit.

rather than forcing the table to fit.

Might be worth switching the table to a list-table since most of the sentences are long?

It would be nice if sphinx-gallery authorized this file to just be a .rst (which would get properly highlighted in the editor and not be subject to irrelevant python linting rules. (@timhoffm IIRC you interact a bit with the s-g team, perhaps you have an opinion there?)
In any case I'll just noqa this file for now.

It would be nice if sphinx-gallery authorized this file to just be a .rst (which would get properly highlighted in the editor and not be subject to irrelevant python linting rules. (@timhoffm IIRC you interact a bit with the s-g team, perhaps you have an opinion there?)

As of today sphinx-gallery does not support this (see https://sphinx-gallery.github.io/stable/syntax.html#plain-rest-examples). I'm not clear whether that's a fundamental design decision or whether it's just not implemented. Technically, that would be perfectly possible. It just slightly complicates the processing in that you have to skip the right parts of the example build.

What you could try as a workaround is making a placeholder .py file and include an .rst

"""
.. include:: actual_content.rst
"""

May need some fiddling to get the path to the rst file right.

Alternatively, just include the table as a separate .rst file or use a list table as suggested by @story645.