Zulip Chat Archive
Stream: new members
Topic: Make Documentation
Sayantan Majumdar (Jul 14 2023 at 18:24):
I am getting totally confused about making a documentation for my lean3 project. I have a project and I have properly commented on every theorem (describing them) is there a way to generate a documentation for my project?
It is a small library with some theorems. I want to generate a documentation for it from the comments (or any other way), like you do in python using sphinx in python or doxygen in c/c++. I cant seem to figure it out
(sorry for the silly question)
Patrick Massot (Jul 14 2023 at 18:43):
Do you mean something that looks like https://leanprover-community.github.io/mathlib_docs/linear_algebra/quotient.html? this is done by docgen.
Yaël Dillies (Jul 14 2023 at 18:53):
Have a look at non-mathlib projects to see how they do it, eg github.com/YaelDillies/LeanAPAP. I'm linking you to my project because many things broke in our general setup and I fixed them in my project last week.
Sayantan Majumdar (Jul 14 2023 at 19:17):
yes, I want to make something like that for my project @Patrick Massot
Notification Bot (Jul 14 2023 at 19:17):
Sayantan Majumdar has marked this topic as resolved.
Notification Bot (Jul 14 2023 at 19:18):
Sayantan Majumdar has marked this topic as unresolved.
Patrick Massot (Jul 14 2023 at 19:18):
You should still be warned that investing time in learning Lean 3 tooling is very unwise. That time would be much better invested in porting your project to Lean 4, and then learn Lean 4 tooling.
Sayantan Majumdar (Jul 14 2023 at 19:20):
Is making documentation easier in lean4? Is there any documentation on making documentation? I can't seem to find it.
Patrick Massot (Jul 14 2023 at 19:20):
I'm not saying it's easier, I'm saying it will be a lot more useful to you.
Patrick Massot (Jul 14 2023 at 19:21):
The project you are talking about is your last Lean 3 project, whereas you could have dozens of Lean 4 projects ahead.
Patrick Massot (Jul 14 2023 at 19:21):
The doc tool is https://github.com/leanprover/doc-gen4/
Sayantan Majumdar (Jul 14 2023 at 19:24):
Thanks will look into it
Henrik Böving (Jul 14 2023 at 19:44):
Sayantan Majumdar said:
Is making documentation easier in lean4? Is there any documentation on making documentation? I can't seem to find it.
it's also very easy, at least I (the author) would claim so :P
Last updated: Dec 20 2023 at 11:08 UTC