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

ocamlbyexample 2.0 #16

Open
mimoo opened this issue Dec 23, 2022 · 0 comments
Open

ocamlbyexample 2.0 #16

mimoo opened this issue Dec 23, 2022 · 0 comments

Comments

@mimoo
Copy link
Contributor

mimoo commented Dec 23, 2022

I think this library did a faux pas. It shouldn't have separated the comments from the text. It's just too much of a pain to create a chapter due to this. I think it should detect, or have the user provide what type of comment is being used in a file, and extract comment from code.

The other faux pas is how the code is broken in sections, where it meets the comments. I think a better model is to calculate how many space the comment creates, and add linebreaks in the code in correct places to pad.

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

1 participant