Dear Ralf,

This is my first post on this group.

I'm a FriCAS user since a while and recently introduced FriCAS to a few 
colleagues who are hackers (i.e. familiar with Mathematica, Python, Git, 
etc.). Unfortunately, the entry bar is still quite high. IMHO this is 
largely due to the incoherent and unmaintained documentation, especially 
the "install" and "examples" sections of the website. Sorry; I understand 
that this project is a community effort and everyone's doing their best. 
But, the documentation definitely needs some improvement.

I wanted to submit a PR to fricas/fricas.github.io: FriCAS documentation 
<https://github.com/fricas/fricas.github.io> but noted that the actual 
sources are scattered across "_sources", the repository fricas/fricas-doc: 
Sources for documentation part of https://fricas.github.io 
<https://github.com/fricas/fricas-doc> and other repositories. Furthermore, 
the tooling (Makefile, etc.) to build the RST files to HTML pages is also 
missing on fricas/fricas.github.io: FriCAS documentation 
<https://github.com/fricas/fricas.github.io>.

If it would be kindly possible to reorganise the sources and provide the 
tooling, I could actually edit the sources and submit a PR on 
fricas/fricas.github.io: 
FriCAS documentation <https://github.com/fricas/fricas.github.io> for your 
review. Alternatively, you could also point me to where to find these and I 
could reorganise everything myself in a PR. It it would be Ok, I want to 
(especially) improve the "install" and "examples" (with broken links, etc) 
sections a bit as a first step.

I feel that once FriCAS installed and going, "the book" is an amazing 
resource and ideally one needs nothing more ! :)

Best regards,
Aravindh Krishnamoorthy
My GitHub profile: aravindh-krishnamoorthy (Aravindh Krishnamoorthy) 
(github.com) <https://github.com/aravindh-krishnamoorthy>


On Saturday, December 23, 2023 at 10:25:14 PM UTC+1 Ralf Hemmecke wrote:

> > The first link works, but few I tried after that are all broken.
>
> Sorry, my fault.
>
> Replace in
>
> http://fricas-wiki.math.uni.wroc.pl/FriCASIntegration
>
> fricas-wiki.math.uni.wroc.pl
>
> by
>
> wiki.fricas.org
>
> so you get (https)
>
> https://wiki.fricas.org/FriCASIntegration
>
> I will regenerate the pages as soon as I can.
>
> Ralf
>
> PS: I am just trying to give you some answer to your "op" question.
>

-- 
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/94b54f98-441f-430d-aa73-836f0260b14cn%40googlegroups.com.

Reply via email to