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

Add helpful information to the SETUP.md #33

Closed
kytrinyx opened this issue Mar 16, 2015 · 2 comments
Closed

Add helpful information to the SETUP.md #33

kytrinyx opened this issue Mar 16, 2015 · 2 comments
Assignees
Milestone

Comments

@kytrinyx
Copy link
Member

The contents of the SETUP.md file gets included in
the README.md that gets delivered when a user runs the exercism fetch
command from their terminal.

At the very minimum, it should contain a link to the relevant
language-specific documentation on
help.exercism.io.

It would also be useful to explain in a generic way how to run the tests.
Remember that this file will be included with all the problems, so it gets
confusing if we refer to specific problems or files.

Some languages have very particular needs in terms of the solution: nested
directories, specific files, etc. If this is the case here, then it would be
useful to explain what is expected.


Thanks, @tejasbubane for suggesting that we add this documentation everywhere.
See exercism.io#2198.

@tmcgilchrist
Copy link
Contributor

Sounds like a good idea, you want the starting experience to be a seamless as possible.
I'll have a go at writing something unless someone else beats me to it.

What's the best way to see how the final README.md looks when running exercism fetch? I haven't really stepped outside the xerlang and xocaml repos.

@kytrinyx
Copy link
Member Author

There's no real easy way to do this at the moment. I tend to run a local version of the x-api server and then request the /problems/:track_id/:problem_slug endpoint. I'll try to come up with a handier way of doing that.

@NobbZ NobbZ added this to the 2016 Overhaul milestone Sep 10, 2016
@NobbZ NobbZ self-assigned this Sep 11, 2016
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

3 participants