Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replacing list of tutorials on the website with link to awesome list? #190

Open
Zimmi48 opened this issue Dec 20, 2021 · 1 comment
Open

Comments

@Zimmi48
Copy link
Member

Zimmi48 commented Dec 20, 2021

Recently, I've proposed that we could extend the list of available Coq documentation on the website to include non-English learning resources: coq/rocq-prover.org#10.

More recently, I've noticed by looking at https://www.google.com/search?q=coq+proof+course&tbm=vid that there are many Coq video tutorials and this could deserve a category on its own in the documentation page.

Overall, I've reflected that keeping a curated list on the website is hard and maybe this is best done externally, e.g. with an awesome list.

The awesome-coq list already has a resources category: https://github.com/coq-community/awesome-coq#resources.

Another possibility would be to have a separate awesome-coq-learning list dedicated to collecting and curating books, tutorials, videos, etc. about Coq. Separate awesome lists for learning exist in several ecosystems:

What do @palmskog and @anton-trunov (awesome-coq maintainers) think? Does it sound like a good idea to replace the list being maintained on the website by a link to an awesome list? Should this become a separate awesome list or is awesome-coq the right place to do this? Are non-English resources and video tutorials good categories to add to such list?

And what do @coq/website-maintainers and @coq/core think?

@palmskog
Copy link
Contributor

palmskog commented Dec 20, 2021

It's a lot of work to set up a new Awesome list and get it listed on the general Awesome list. If someone did it for "Coq learning", I would reference it from the Awesome Coq list and probably remove/outsource some of the Awesome Coq resources.

In the meantime, there are three kinds of learning resources that can be listed on Awesome Coq:

  • Books in English related to Coq
  • Course material in English related to Coq
  • Tutorials in English or as pure Coq code

For learning resources outside this scope (non-English books, courses, and any videos), I think the best place is currently the Coq wiki.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants