Zulip Chat Archive

Stream: mathlib4

Topic: Style: Documenting Proofs


Rudy Peterson (Nov 13 2025 at 00:37):

Hello,

What is the preferred style for inling documentation for proofs?

Specifically, is there any style guides for this on Lean community (my apologies for missing this).

Thank you!

Weiyi Wang (Nov 13 2025 at 01:53):

Are you asking about -- comment vs /- comment -/in the middle of a proof? Last time I used -- comment in a long PR and it was accepted, so I guess that was fine

Kim Morrison (Nov 13 2025 at 02:30):

Use -- is it's only a line or two, /- if you're writing paragraphs.


Last updated: Dec 20 2025 at 21:32 UTC