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

Guide with mdbook #975

Merged
merged 4 commits into from
Mar 21, 2024
Merged

Guide with mdbook #975

merged 4 commits into from
Mar 21, 2024

Conversation

arnaudgolfouse
Copy link
Collaborator

This moves the user documentation out of the README (which was starting to be a bit busy IMO) an into the already existing mdbook.
I also filled some sections, but a lot more remains to be done.

It would also be cool if we could check that the examples are indeed provable (or even compilable) in CI.

- Various placeholder sections
- Section on final reborrows
- Section on requires/ensures
- Section on snapshots
This also removes the `guide-ci.yml` workflow, since the example we want to test need Creusot instead of normal Rust.
@xldenis
Copy link
Collaborator

xldenis commented Mar 20, 2024

I also filled some sections, but a lot more remains to be done.

Thanks for starting the work!

I think we can merge this PR but here are two ideas for the future of README:

  • Include a BibTex entry for easy citing, also probably put this lower down.
  • Replace the "Examples of verification" with an inline simple example. This could be useful for new users to use a smoke test additionally.

@arnaudgolfouse arnaudgolfouse merged commit b600494 into creusot-rs:master Mar 21, 2024
4 checks passed
@arnaudgolfouse arnaudgolfouse deleted the guide branch September 3, 2024 11:04
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

Successfully merging this pull request may close these issues.

2 participants