Right now there are two conventions throughout Sage for bullet points (and similar things). Someone has been systematically trying to change everything to one convention (which I am opposed to). However, we as a community have not had a discussion about this as far as I am aware (I believe also changing the example doc page at some point). I figured we should have this conversion now.
The question is this: Should there be blanklines between bullet points: Pros (these are the ones I can see, but I am biased): - It makes it more clear what bullet point is which. - It could be easier to read as it looks less like a big paragraph of text. Cons: - IMO it looks really bad when there are few bullet points and they are really short. - I find it *harder* to separate bullet points from non-bullet points, especially when separated by single lines * This includes sublists, which must have a blank line before/after them (just like normal lists). - It makes it more clear that these bullet points should be thought of as a single collection. - Because blanklines separates a list from the body of text, it makes it seem like the bullet points are each their own list of single items. Note that this does not change the compiled doc, but I typically am not looking at that. What is your opinions? I think it is clear that I am for no blanklines between bullet points. Best, Travis -- 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/5039446f-3d96-4065-a9eb-7be070ebb1e6n%40googlegroups.com.
