Skip to content

Conversation

@01mf02
Copy link
Contributor

@01mf02 01mf02 commented Feb 8, 2024

This should address #2351.

@laurmaedje
Copy link
Member

I am not entirely comfortable with this example in the docs. The box(width: 35pt, ..) thing is relatively hacky (I know that I proposed it in the linked issue). I understand that it would be useful to have more examples in the docs, but the docs also have normative character, so I would prefer to only add idiomatic examples there. In particular, the box solution ensured that the heading's title is always at the same position (independently of the numbering), which is not exactly what the description here reflects.

I am also not sure in how far the top section of each element should accumulate various different examples for the element. It will shift the synopsis down quite a lot. I think we need to figure something out for adding more cookbook-style examples.

@laurmaedje
Copy link
Member

I'll close this for now, but we can reopen should more discussion come to some conclusion.

@laurmaedje laurmaedje closed this Feb 20, 2024
@01mf02
Copy link
Contributor Author

01mf02 commented Feb 20, 2024

OK! Thanks for taking the time to explain.

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