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

2024-02-04 Thread Kwankyu Lee
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 ... Thanks for the pointers. The

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

2024-02-03 Thread Kwankyu Lee
I was going to suggest to use uppercase only for header-like directives, excluding thereby ".. math::" in particular. but as Travis expressed, it would be confusing to change a long-held tradition, unless there is unanimous agreement. So I will stop here. Thanks for the info and opinions. On

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

2024-02-03 Thread 'Travis Scrimshaw' via sage-devel
I think it is more confusing to mix the two. I vote for keeping everything all uppercase since everything else that is analogous uses all uppercase letters. Best, Travis On Wednesday, January 31, 2024 at 9:20:58 PM UTC+9 TB wrote: > On 25/01/2024 7:06, Kwankyu Lee wrote: > > Hi, > > Our

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

2024-01-31 Thread 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

[sage-devel] Sphinx directives in upper case?

2024-01-24 Thread Kwankyu Lee
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