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

Revamp README #442

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from
Draft

Revamp README #442

wants to merge 3 commits into from

Conversation

sorawee
Copy link

@sorawee sorawee commented Dec 2, 2023

This is a draft of a README improvement. Right now I only made a pass on the first few sections, but I intend to go through all of them. Eventually, we can also port the README to odoc (as attempted in the stale #355). I submit this a a draft PR now in case anyone would like to provide a feedback.

Intending to resolve: #421, #352, and #273

Help needed

If anyone knows the compatibility of MDX stanza 0.3 (what version of MDX and Dune it works with), please let me know!

`-` in the `files` clause matches a file named `-`. This is probably a mistake.
Use h1 for the title, h2 for sections, h3 for subsections, etc.
- Fix dead links
- Improve organization
- Update the `using` clause's version
- Add a compatability section. One TODO remains.
- Make the example more interesting
  (by introducing an unintentional compilation error)
@samoht
Copy link
Collaborator

samoht commented Dec 6, 2024

That looks really great - Happy to merge it even if that's not finished. Feel free to remove the Draft status when you feel like ready.

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.

Support for silent blocks
2 participants