Convert the main page readme to a wiki?

[cugone]

The main page readme is quite long and might be better served as a multi-page, searchable github wiki.

[Nelarius]

I think the README is actually preferable at the moment:

• it's a part of the code, which means that if you need to look something up, you can open the file up in the text editor, where you're likely working anyway.
• table of contents makes it fairly easy to find & jump to entries.
• the README is close to the code, so hopefully it will be easier to keep in sync with code changes. I have seen too many horrendously out of data wikis 😅

[Nelarius]

There was actually an earlier issue about this: https://github.com/nicbarker/clay/issues/60

[cugone]

There was actually an earlier issue about this: #60

And Nic himself even said it was a good idea.

[pengowray]

Information on github wikis is always hard to find because they're not indexed by search engines. Many projects avoid them for this reason.

For details see: Permit search engines to index Github wikis #4992

(I have no stake in this, just chiming in.)