Launch C# track! about csharp HOT 30 CLOSED

I can also take a shot at the help page or anything else, if needed.

from csharp.

Sweet! The help page is the most critical piece missing in order to launch the track.

We've got 10 exercises ported to C#, and there are many more that could be ported if you feel motivated to do so. I deploy the exercises API more or less daily, as people add exercises in the various languages.

Once it's launched if you can help with the nitpicking, that's always a huge help.

from csharp.

Anytime! I'll start messing with it today. Just to double check and that I don't look dumb doing it a different way, this will just be included the readme.md file?

from csharp.

The help stuff will go onto the main website under the help menu.

We can also add a SETUP.md with instructions about how to run the tests and things, which will get included in the README. (I do apologize for this being confusing!)

from csharp.

I believe I found where it is! I'll fork and make the appropriate updates.

No apologies necessary! I'm still fairly new to how this is all laid out so the fault is mine. :]

from csharp.

You just found my next experiment :) I will be moving all the documentation out of the main app, since it changes at a completely different rate than the website stuff.

In the meanwhile, it's here: https://github.com/exercism/exercism.io/tree/master/lib/redesign/articles/help/setup

Once I have the docs site completed, I'll move all the existing commits over (so everyone gets credit).

from csharp.

Awesome! I'll update the main site and send a request. :]

I appreciate the help!

from csharp.

I'm willing to look at the help page but if @jwood803 wants to take a shot at it, go for it. Let me know if you want someone to review your changes.

I can definitely help start the nitpicking (one of my primary motivations for moving this along). I have some community friends to help as well once it launches.

from csharp.

I would love the review! I appreciate the offer.

-----Original Message-----
From: "Bressain Dinkelman" [email protected]
Sent: ‎5/‎4/‎2014 3:08 PM
To: "exercism/xcsharp" [email protected]
Cc: "Jon" [email protected]
Subject: Re: [xcsharp] Launch C# track! (#7)

I'm willing to look at the help page but if @jwood803 wants to take a shot at it, go for it. Let me know if you want someone to review your changes.
I can definitely help start the nitpicking (one of my primary motivations for moving this along). I have some community friends to help as well once it launches.
—
Reply to this email directly or view it on GitHub.

from csharp.

Is it possible to add screenshots to these pages?

@dinkelburt I'm not sure of the best way for you to review, but you can always take a peek at what I have in the branch - csharp.md.

from csharp.

Yes, you can add images: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet.

Looks good so far. It may be worth mentioning how to set up Nuget on the Windows track to install nunit.

May or may not be worth adding to the help file but here is how I set my environment up:

1. Create a solution separate from the exercism directory
2. When starting a new exercise, make a folder in the solution by the same name
3. Add the files from the exercism directory (right click folder >> Add >> Existing Item >> (select files) Add As Link (drop-down from Add)

This makes it so you never have to copy files around or clutter the exercism directory with project or other files (using R# or NCrunch can get messy). Keep in mind that I have VS Premium not Express so some of these options might not be available so try them out first.

from csharp.

Thanks! And good point on creating separately from the exercism directory.

I also figured it may be worthwhile to include compiling from the command line, as well. I just installed Express to make sure the instructions work well with it.

from csharp.

Feel free to add images to lib/app/public/img/setup/csharp (or something like that. Create whatever subdirectories make sense). They'll be accessible via /img/setup/csharp/whatever.png.

from csharp.

Oh hey look, buttons 😳 (yeah, I'm new here).

from csharp.

@dinkelburt I did a few more updating on it. Would you mind taking a look when you get a chance, please? If there's a better way for you to review, just let me know. Thanks!

Actually, the images seem to not going to the right path. I guess relative path here isn't the best solution.

from csharp.

I guess relative path here isn't the best solution.

As long as you start with /img/... it should work fine.

from csharp.

I must still be missing something since they still appear to be broken :/.

I'll mess with it more tonight, but it looks like some good progress so far. I figured it may be safe to launch with just the Visual Studio Express portion completed and I (and/or others) can update the command line compiler portion.

from csharp.

Oh! Sorry — they will be broken on GitHub, but they'll work on the website.

from csharp.

Ahhh, I see! I'll update them to start with /img/....

Thanks for the help!

from csharp.

@jwood803 looking good so far.Y'know, I've been thinking and in the context of actually doing the exercises, it probably doesn't matter where the solution/project sits as you only submit the one file and the exercism directory isn't a git repo. In fact, they may want to create the solution right in the exercism/csharp directory.

Some other details to consider:

1. We might want to actually show screens on where the test runners are located and how to run them.
2. Once NUnit is installed, people probably won't care about the Package Manager Console so I would consider removing that part.
3. People can choose whether to use the CLI tools or not but I would at least mention that MonoDevelop provides an IDE they can use.

@kytrinyx something I noticed with other tracks is tests are skipped until people are ready to address them (xit vs it in js, removing skip in ruby, etc.). That can be done easily for C# but because the initial exercises weren't doing it, I followed suit. Is it cool if I do another pass on the exercises to add that as well as some other tweaks?

from csharp.

@dinkelburt Yeah, absolutely. I think adding skips is helpful in that you don't have to try to parse/deal with all the errors at once. It makes it feel more like TDD, even though you're not using the tests to drive design, really.

from csharp.

@dinkelburt Thanks for taking a look!

Adding how to use the NUnit runner was the last thing I knew I had to finish and we can perhaps get this out and ready to launch after that.

I know most developers, that I've seen, use the Package Manager Console a lot. However, since this is for people getting started it may be worth just leaving that out.

I've never messed with the Mono tools. I'll add that and I appreciate the work on that part.

I should have something to send today. After this I can add a few of the exercises, as well.

from csharp.

@jwood803 I added Ignore to all the tests except the first so it would be good to mention something about it in the help file like "to do the next test, remove Ignore from the test method attributes".

Once you're done with everything, I think we're good to launch.

from csharp.

Awesome! I just finished adding the other items.

@kytrinyx I'll send a PR shortly, but if I miss anything or if it isn't the correct process, just let me know.

from csharp.

It looks great! I'm very excited that we'll get this launched today ✨

from csharp.

I'm deploying today. @dinkelburt, I'm making you admin in the C# track so you can see all the submissions. If you hate that, let me know and we'll find another way :)

from csharp.

Awesome! I'll try the admin thing and I'll let you know. 😄

from csharp.

You'll do great! :]

from csharp.

I'm guessing this can be closed. :]

from csharp.

Hah. Yeah, it does seem that way. Thanks!

from csharp.