Skip to content

Libdoc: Leave out the return type column when there is no type - #5798

Open
aaltat wants to merge 1 commit into
robotframework:masterfrom
aaltat:libdoc_table_columns
Open

aaltat wants to merge 1 commit into
robotframework:masterfrom
aaltat:libdoc_table_columns

Conversation

@aaltat

@aaltat aaltat commented Sep 23, 2026

Copy link
Copy Markdown
Contributor

Give the argument name column a minimum width

@pekkaklarck pekkaklarck left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Please clarify or remove comments.

Comment thread src/web/libdoc/styles/main.css Outdated
below, an argument name in the one above. Seven rem is about thirteen
monospace characters, which covers nine in ten of the argument names in
the standard libraries. It is a minimum and not an alignment: a longer
name still widens the column. */

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is a rather confusing comment in general and especially the first sentence looks gibberish to me. Isn't the point that these columns have a minimum width? In that case, why is a comment needed in the first place when the style that's commented contains min-widht: 7rem?

This mush be an AI generated doc. There's nothing wrong in using AI, but the results should be reviewed and modified when needed.

Comment thread src/web/libdoc/libdoc.html Outdated
{{! A column that would have nothing in it is left out
altogether, as in the argument table above. A
keyword can document what it returns without
annotating a type. }}

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This looks like a very verbose way to say "Hide empty columns". I'm not sure is a comment really needed here in the first place.

Give the argument name column a minimum width
@aaltat
aaltat force-pushed the libdoc_table_columns branch from 96e703c to 63b8c31 Compare September 24, 2026 17:47

This branch has not been deployed

No deployments
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.

2 participants