Re: [sage-devel] Sphinx directives in upper case?

[TB]

On 25/01/2024 7:06, Kwankyu Lee wrote: Hi, Our developer guide dictates to write Sphinx directives in upper case. So for example, ".. MATH::" instead of ".. math::". By the way, it seems that Sphinx community seems to regard lower case as norm. So my question is: why do we insist upper case? Could anyone point to a discussion thread that decided on this? More than 13 years ago we have https://github.com/sagemath/sage/issues/10077 and https://github.com/sagemath/sage/issues/10078 that have comments about the case. Some further history might stem from stropping... For those looking in the docs, one place is here. On 25/01/2024 10:18, Kwankyu Lee wrote: In my humble opinion,  except  ".. SEEALSO::", "..WARNING::", ".. TODO::", ".. NOTE::", ".. RUBRIC::", ".. PLOT::", "..TOPIC::", which seek for reader's attention,  we should use lower case (by default) for all other directives, following Sphinx community's trend. In particular, ".. MATH::" is only distracting. No strong opinion from me, except maybe for having consistency within a given file. The INPUT and OUTPUT blocks are related, but they are not directives. Do you think they should be? Regards, TB -- 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/b3ac9046-7edd-4f57-8e08-e5a198e0295e%40gmail.com.