If there were a file README.rst (written in reStructuredText), then
Github displays it nicely formatted. I've just quickly produced examples
for FriCAS (that's unfinished).
Using a .rst Format would have the advantage, first, to display nicely
when people browse the code at github and second, I could take those
files and include them at https://fricas.github.io.
In other words, all out pure text files like README, INSTALL, FAQ should
be translated into reStructuredText. While this is done, the text in
these files should be revised. They simply become more visible/readable
over the web while still being nicely readable when viewed in a simple
text editor.