Hello, Le lun. 2 déc. 2024 à 18:07, 'Ralf Hemmecke' via FriCAS - computer algebra system <fricas-devel@googlegroups.com> a écrit : > > On 12/2/24 00:38, Waldek Hebisch wrote: > > http://wiki.fricas.org/public/api2.spad > > I'd like to wait with my feedback until I see others (especially those > that USE https://fricas.github.io/api) say an opinion about the produced > output from api2.spad.
I hope it's not about me. To speak apart I find this very interesting, I tried it, yes, it does not support docstrings for example, my principal concern in this area, but I looked at the api.spad code and it is too heavy for me. I looked at it to see if it was possible to add something like a plugin/addon to support MarkDown. I am not for or against restructuredText or Markdown, just I little like the LaTeX syntax in MarkDown. Of course it is not LaTeX, just a very _small_ subset, but from a pragmatic point of view I see this simpler to use it to improve documentation in panAxiom. Furthermore via Jekyll it is supported by GitHub so it is a plus. To say the truth, what I think deep inside me, it's more a proof of concept I think. I agree Sphinx doc adds tons of build time, I know I am used before committing something in my repository but on the other hand I like the idea of having different formats but Sphinx generated documentation is something "relatively" beautiful. - Greg PS: I have seen the discussion on the utility or not to use restructuredText for the README file but at that time I was totally novice in this area. I am still a novice. > 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 fricas-devel+unsubscr...@googlegroups.com. > To view this discussion visit > https://groups.google.com/d/msgid/fricas-devel/95a7f715-479b-4622-a511-bf3a8c4e96e7%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 fricas-devel+unsubscr...@googlegroups.com. To view this discussion visit https://groups.google.com/d/msgid/fricas-devel/CAHnU2dbYobgO%2ByA4uaRyv5dXkS038Lj-nJfQkB%2B-XYpy8b6XNA%40mail.gmail.com.
