I am "no" to having a Sage policy dictating blank lines, and I am also "no" to having a policy dictating no blank lines. As Kwankyu Lee points out, sometimes a blank line is useful, sometimes it isn't. We should leave it up to the judgment of each individual developer.
On Tuesday, July 12, 2022 at 6:53:23 PM UTC-7 Kwankyu Lee wrote: > Bullet points are used in sage mainly in two places: > > (1) AUTHORS section in the doc string of a file > (2) INPUTS section in the doc string of a class or function definition > > In (1), we usually look from the top to the bottom. This list may get > longer and longer. So no blank line between points seems better. > > In (2), each argument ``arg``: is explained in a few sentences and easily > takes more than one line. A blank line between arguments helps separate > explanations for different arguments. > > So I am +1 to no blank line to (1) and one blank line to (2). > > > > > > -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/71b22626-9880-4f1d-931e-42746aefb593n%40googlegroups.com.
