On Sat, 3 Oct 2020, 09:50 Ralf Hemmecke, <[email protected]> wrote: > On 10/3/20 10:11 AM, Dima Pasechnik wrote: > > Certainly these docs are much nicer in rst than in plain text - although > I > > would use markdown (md) format, which is easier in many ways. > > I considered Markdown, but decided against it for two reasons. > 1) Sphinx uses rst by default and sphinx was more important for > the whold documentation effort. >
sphinx handles markdown just as well, with one extra package installed. 2) Markdown is ambiguous and there are too many variants. > (github-flavored markdown, commonmark, etc.) > > Since adding INSTALL and FAQ to the web makes sense, using rst instead > of md would not introduce yet another markup language. > Do you have any rst files, or are (planning to start) generating them automatically, using sphinx lisp? If there is anything to learn about the use of sphinx in SageMath, stay away from attempts to speed it up used handwritten extensions. And rst syntax is hard to get right, it's a constant struggle in SageMath. > > Ralf > > -- > You received this message because you are subscribed to the Google Groups > "FriCAS - computer algebra system" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/fricas-devel/d2976912-c485-3487-30ef-d4dde43cc3d8%40hemmecke.org > . > -- You received this message because you are subscribed to the Google Groups "FriCAS - computer algebra system" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/fricas-devel/CAAWYfq2%2BrfRw91pK2KJPspdr_bPgSnB4ykMCKDOBxfnwL2BhXA%40mail.gmail.com.
