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.
On Sat, 3 Oct 2020, 00:32 Ralf Hemmecke, <[email protected]> wrote: > > In lynx current INSTALL shows nicer than the new version. > > Huh, you read text files with lynx? > > > INSTALL should be readable as plain text and it is in toplevel > > directory so that users can find it easily. Similarly README. > > I have not removed them. But now they point to the .rst version or the > .html version on the web. > > And you must admit reStructuredText is pretty readable even as plain > text file. > > > FAQ is less critical but also deserves to be at top level. > > There is also a link in the top-level FAQ file. > > > AFAICS web servers have no trouble showing text files. So only > > potential gain is due to added links. > > You miss my whole point. I want to make information more visible. For > that I started the whole fricas.github.io business. If you now tell me > that I should just display plain text files where a simple change to > .rst would look much nicer for most people reading at fricas.github.io, > that would be counterproductive. > > > However README is pretty short and INSTALL is rather easy to navigate > > using text search, so IMO gain from links is marginal. > > > The .rst files when viewed as plain text do not look bad, however in > > total this change for me looks like unnecessary complication. > > OK this sounds not like you are totally against it. Since I maintain the > documentation part, I understand this as a "go on". Note that I would > like to bring most of the documentation to fricas.github.io and make it > easier for contributors to jump in. > > Have you ever pressed the "edit on github" link that appears, for > example at the right box at http://fricas.github.io/features.html or at > the top of http://fricas.github.io/api/Algebra.html ? > (But please try it with Firefox or Chrome. Lynx will most probably not > be so nice --- sorry, but I cannot test lynx --- I would have to learn > too much I don't need.) > When detecting errors on the page, people can press the link, edit the > file online and by saving it automatically send a pull request. > > The reStructuredText format is probably not for you, but please do not > stop me from using it to try to attract new users. > > 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/4587839f-66b2-301d-4800-69050edfeaab%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/CAAWYfq3hxCmV1%2B2Se4BY03Cd4u%3DAvP6PZTtQ_o8sogA%2BYV9vtQ%40mail.gmail.com.
