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

Generate exercise READMEs from templates #55

Merged
merged 2 commits into from
Jul 22, 2017
Merged

Conversation

kytrinyx
Copy link
Member

@kytrinyx kytrinyx commented Jul 10, 2017

We are working towards making exercises stand-alone.
That is to say: no more generating READMEs on the fly.

This will give maintainers more control over each individual exercise
README, and it will also make some of the backend logic for delivering
exercises simpler.

The README template uses the Go text/template package, and the default
templates generate the same READMEs as we have been generating on the fly.
See the documentation in regenerating exercise readmes for
details.

The READMEs can be generated at any time using a new 'generate' command in configlet. This command has not yet landed in master or been released, but can be built from source in the generate-readmes branch on configlet.

Tracking progress of all tracks in: exercism/meta#15

@kytrinyx
Copy link
Member Author

Please hold off on merging this. In exercism/configlet#24 we're talking about having a default template in the repository that we can use instead of duplicating the template everywhere. That way only the exercises that want to change the default would actually have a template.

@kytrinyx kytrinyx force-pushed the generate-readme branch 2 times, most recently from 4bd1329 to b957869 Compare July 16, 2017 19:03
@kytrinyx
Copy link
Member Author

This should be good to go provided that the build passes.

We are working towards making exercises stand-alone—that is to say:
no more generating READMEs on the fly.

This will give maintainers more control over each individual exercise
README.

The template uses the Go text/template package, and the default templates
generate the exact same READMEs as we have been generating on the fly.
@kytrinyx
Copy link
Member Author

Updated to generate READMEs for the exercises that got added since this was implemented.

@kytrinyx kytrinyx merged commit 61f583f into master Jul 22, 2017
@kytrinyx kytrinyx deleted the generate-readme branch July 22, 2017 15:03
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.

1 participant