DOC: separate and clarify axisartist default tables #26754
Conversation
story645
added
topic: mpl_toolkit
Documentation: user guide
story645
force-pushed
the
axisartist-table
branch
2 times, most recently
from
b74aea1
to
7884883
Compare
story645
force-pushed
the
axisartist-table
branch
from
7884883
to
e920a6d
Compare
There was a problem hiding this comment.
+1 on splitting the table. -1 on changing to list table style. As said in #26737 (comment)
As long as the tables are small (like in this example), I prefer ReST simple tables. Yes they are more cumbersome to update but they are much easier to read, and readability counts. It's not that we are changing these tables all the time.
|
I may be the anomaly but I don't find the list tables harder to read if the table is sensible since it's still row/column order. And I usually have the rendered docs open. On the flip side, I find the hardcoded tables orders of magnitude more annoying to edit - I dunno if it's a byproduct of being on Windows or eyestrain but I always manage to miss something, especially when I have to cascade the changes. |
|
I accept your different standpoint. Let’s if others have an opinion. |
|
I'm with Tim here. Two tables clearly made it better (from both source and rendering perspectives), but still I find the "hard-to-edit" tables much easier to understand. |
story645
force-pushed
the
axisartist-table
branch
from
e920a6d
to
9378efe
Compare
story645
force-pushed
the
axisartist-table
branch
from
9378efe
to
81cdff8
Compare
|
changed to grid tables c/o nice vs code plugins + table usage doc/section formatting |
doc/devel/document.rst
Outdated
| +-------------+-------------------------------+--------------------+ | ||
| | | small table | large table | | ||
| +-------------+-------------------------------+--------------------+ | ||
| | short entry | `simple or grid table <sg>`__ | `grid table <sg>`_ | |
There was a problem hiding this comment.
I think there's one underscore too much:
| | short entry | `simple or grid table <sg>`__ | `grid table <sg>`_ | | |
| | short entry | `simple or grid table <sg>`_ | `grid table <sg>`_ | |
| === ========== ======= | ||
| The axisartist toolkit | ||
| === ========== ======= |
There was a problem hiding this comment.
I assume this is unintended. Have you been playing with table formatting too much? 😜
There was a problem hiding this comment.
probably a format all instead of format this
story645
force-pushed
the
axisartist-table
branch
from
81cdff8
to
53795d5
Compare
|
fixed |
story645
force-pushed
the
axisartist-table
branch
from
53795d5
to
be1c941
Compare
|
Owee, I'm MrMeeseeks, Look at me. There seem to be a conflict, please backport manually. Here are approximate instructions:
And apply the correct labels and milestones. Congratulations — you did some good work! Hopefully your backport PR will be tested by the continuous integration and merged soon! Remember to remove the If these instructions are inaccurate, feel free to suggest an improvement. |
|
Owee, I'm MrMeeseeks, Look at me. There seem to be a conflict, please backport manually. Here are approximate instructions:
And apply the correct labels and milestones. Congratulations — you did some good work! Hopefully your backport PR will be tested by the continuous integration and merged soon! Remember to remove the If these instructions are inaccurate, feel free to suggest an improvement. |
QuLogic
changed the title
PR summary
Based on discussion in #26737, rotated the parameter default table in the AxisArtist guide and seperated it out into two to try and clarify that the table is showing the default label parameter values for each reference direction.
general new look:
attn: @oscargus
PR checklist