search

gilch / hissp

It's Python with a Lissp.
https://gitter.im/hissp-lang/community
Apache License 2.0
369 stars 9 forks source link

Rethink FAQ #157

Open gilch opened 2 years ago

gilch commented 2 years ago

Given the new bundled macros #154 #155, a lot of the FAQ is looking pretty dated. It's also not from actually-asked questions, but anticipated ones. Maybe it's time to get rid of it. A few of them did end up getting asked in the chat room though. It was nice to be able to link to them. The old doc versions are still available though.

Given GitHub's Discussions feature, we probably don't need to keep this part in the Sphinx docs, although those do have the advantage (and disadvantage) of Sybil testing.

There are some valuable tips in there that aren't anywhere else. Those can maybe be converted to their own section or moved to the wiki.

gilch commented 2 years ago

Deleted FAQ in #158. I can still point to an older version of the docs if necessary, I just won't be maintaining it anymore. I'll probably look over it again in my next doc edit pass to see if anything should be moved.

gilch commented 2 years ago

I'm thinking of making a "cookbook" section in the docs with how-tos. That's what a lot of the old FAQ was.