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 #31

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

Add helpful information to the SETUP.md #31

kytrinyx opened this issue Mar 16, 2015 · 3 comments

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.

@kevinvanderlugt
Copy link

I think @masters3d added the basic information in c9ae5bc

I have a slightly different way of running the test that I find to be easier. Instead of creating one xCode project for each exercise, I have one generic exercism xCode project. Then I just need to drag in the newest exercise, create the new file for the solution and add that to the Tests target.

Curious how everyone else does it since it seemed like the original setup was a lot of extra overhead when I got started. Maybe this should be discussed in a different issue though?

@masters3d
Copy link
Contributor

I think using IOS as the test bed is the most straightforward way. (maybe not the fastest)
But if you have suggestions on changes see the docs repo
https://github.com/exercism/docs/blob/master/app/pages/languages/getting-started-with-swift.md

A lot of issues could be introduced when you start to mix multiple projects. For example. You cant have files with the same name in one xcode project.

I personally just use an osx project since those build faster for me but that can get confusing when people see something like this and accidentally click yes.
image

@kevinvanderlugt
Copy link

Yeah, I suppose I can see how having all the tests in one project could get confusing if you wanted to name your solution the same as a file that already exists.
Usually I end up naming it the name of the class that is going to be tested though. Or if it's an extension I add the in the filename what is getting added to the class.

I will have to give an osx project a try since ios projects always open the simulator.
Eitherway, I think this issue can be closed with your commit earlier?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants