about FAQ

[Qian Yun]

I'd like to change current FAQ to FAQ.rst with:

See `<src/doc/sphinx/source/faq.rst>`_ or
https://fricas.github.io/faq.html.


So that the link can be navigated to the real sphinx one on github.

Also, I'd like to add numbering to the FAQ entries, so that it is easier
for users to reference them.

Also to move the last 6 entries from section "Old Axiom FAQ" to
"General Questions"?

- Qian

[Ralf Hemmecke]

On 5/24/26 01:34, Qian Yun wrote:
> I'd like to change current FAQ to FAQ.rst with:
>
> See `<src/doc/sphinx/source/faq.rst>`_ or https://fricas.github.io/
> faq.html.

I don't understand.

Look at

https://github.com/fricas/fricas/blob/r1.3.13/src/doc/sphinx/source/faq.rst

It is already there.

> Also, I'd like to add numbering to the FAQ entries, so that it is
> easier for users to reference them.

Maybe adding some markup to be able to present a URL per question would
be a good idea.

> Also to move the last 6 entries from section "Old Axiom FAQ" to
> "General Questions"?

Hmmmm... not sure about that. But the 2 sections are only there for
historical reasons, maybe they are not necessary at all. Anyhow, it
would be good to plan some time for revising fac.rst before every release.

Ralf

[Qian Yun]

On 5/26/26 3:12 PM, 'Ralf Hemmecke' via FriCAS - computer algebra system
wrote:

> On 5/24/26 01:34, Qian Yun wrote:
>> I'd like to change current FAQ to FAQ.rst with:
>>
>> See `<src/doc/sphinx/source/faq.rst>`_ or https://fricas.github.io/
>> faq.html.
>
> I don't understand.
>
> Look at

> https://github.com/fricas/fricas/blob/r1.3.13/FAQ

> https://github.com/fricas/fricas/blob/r1.3.13/src/doc/sphinx/source/faq.rst
>
> It is already there.

I mean, at this page https://github.com/fricas/fricas/blob/r1.3.13/FAQ
you can not do a click and go to the faq.rst source page.
Also the html link is not clickable.

>> Also, I'd like to add numbering to the FAQ entries, so that it is
>> easier for users to reference them.
>
> Maybe adding some markup to be able to present a URL per question would
> be a good idea.

Currently there's already URL link per question on github
source page and fricas.github.io site?

>> Also to move the last 6 entries from section "Old Axiom FAQ" to
>> "General Questions"?
> Hmmmm... not sure about that. But the 2 sections are only there for
> historical reasons, maybe they are not necessary at all. Anyhow, it
> would be good to plan some time for revising fac.rst before every release.
>
> Ralf
>

I think the last 4 entries are fricas specific?

- Qian

[Ralf Hemmecke]

On 5/26/26 11:38, Qian Yun wrote:
> On 5/26/26 3:12 PM, 'Ralf Hemmecke' via FriCAS - computer algebra system
> wrote:
>> On 5/24/26 01:34, Qian Yun wrote:
>>> I'd like to change current FAQ to FAQ.rst with:
>>>
>>> See `<src/doc/sphinx/source/faq.rst>`_ or https://fricas.github.io/
>>> faq.html.
>>
>> I don't understand.
>>
>> Look at
>> https://github.com/fricas/fricas/blob/r1.3.13/FAQ
>> https://github.com/fricas/fricas/blob/r1.3.13/src/doc/sphinx/source/faq.rst
>>
>> It is already there.
>
> I mean, at this page https://github.com/fricas/fricas/blob/r1.3.13/FAQ
> you can not do a click and go to the faq.rst source page.
> Also the html link is not clickable.

Ah, now I understand.

>>> I'd like to change current FAQ to FAQ.rst with:
>>>
>>> See `<src/doc/sphinx/source/faq.rst>`_ or
https://fricas.github.io/faq.html.

And you believe that then it would be clickable? In fact, FAQ can be
removed completely, but I only left it there for the old guys that
prefer text files (and browse in the local file system -- not on github)
and get an idea where to look for the information.

>>> Also, I'd like to add numbering to the FAQ entries, so that it is
>>> easier for users to reference them.
>>
>> Maybe adding some markup to be able to present a URL per question would
>> be a good idea.
>
> Currently there's already URL link per question on github
> source page and fricas.github.io site?

Yes, I've obviously though about it and included the table of contents.
Sorry, I actually should have looked more closely on the faq.html page.

>>> Also to move the last 6 entries from section "Old Axiom FAQ" to
>>> "General Questions"?
>> Hmmmm... not sure about that. But the 2 sections are only there for
>> historical reasons, maybe they are not necessary at all. Anyhow, it
>> would be good to plan some time for revising fac.rst before every release.

> I think the last 4 entries are fricas specific?

Probably.
I'm not against a revision, i.e. removing the FriCAS/Axiom distinction
and maybe even removing irrelevant stuff.

Ralf

[Waldek Hebisch]

On Tue, May 26, 2026 at 05:38:24PM +0800, Qian Yun wrote:
>
> >> Also to move the last 6 entries from section "Old Axiom FAQ" to
> >> "General Questions"?
> > Hmmmm... not sure about that. But the 2 sections are only there for
> > historical reasons, maybe they are not necessary at all. Anyhow, it
> > would be good to plan some time for revising fac.rst before every release.
> >
> > Ralf
> >
>
> I think the last 4 entries are fricas specific?

All entries are FriCAS specific in the sense that answers were
updated and things that are no longer a problem are omited.

And AFAICS the last 4 entries are new, they were not in old Axiom
FAQ. So, they are misplaced.

--
Waldek Hebisch