-
Notifications
You must be signed in to change notification settings - Fork 131
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
Examples/Demos have become unmaintainable #358
Comments
I haven't really seen any convincing embedded doc examples yet. They also tend to bitrot very quickly because even if they can be compiled and do compile, people tend to put important details into the commentary because you can't really code it out and that doesn't see any testing or updates. Also the important part is being able to transfer doc examples back into real projects and is often a big stumbling block, even if the doc example is actually good.
My two cents: In Maybe there's some middle ground? |
We currently have 24 independent demo projects in the
examples
directory, each with its ownCargo.toml
that needs to be maintained, some being of questionable didactic value or demonstrating functionality that is already incorporated in another demo. Many haven't been updated ever since they were added, except for fixing breakage. This is not maintainable.I'm declaring a moratorium on adding more examples until we fix this.
I propose that we:
demos
) and make them actual Cargo examplesOther solutions welcome.
The text was updated successfully, but these errors were encountered: