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

Ensure Windows PowerShell track is ready for v2 launch #81

Closed
8 of 9 tasks
kytrinyx opened this issue Jun 12, 2018 · 7 comments
Closed
8 of 9 tasks

Ensure Windows PowerShell track is ready for v2 launch #81

kytrinyx opened this issue Jun 12, 2018 · 7 comments
Assignees

Comments

@kytrinyx
Copy link
Member

kytrinyx commented Jun 12, 2018

There are a number of things we're going to want to check before the v2 site goes live. There are notes below that flesh out all the checklist items.

  • The track has a page on the v2 site: https://v2.exercism.io/tracks/powershell
  • The track page has a short description under the name (not starting with TODO)
  • The "About" section is a friendly, colloquial, compelling introduction
  • The "About" section follows the formatting guidelines
  • The code example gives a good taste of the language and fits within the boundaries of the background image
  • There are exercises marked as core
  • Exercises have rough estimates of difficulty
  • Exercises have topics associated with them
  • The first exercise is auto_approve: true

Track landing page

The v2 site has a landing page for each track, which should make people want to join it. If the track page is missing, ping @kytrinyx to get it added.

Blurb

If the header of the page starts with TODO, then submit a pull request to https://github.com/exercism/powershell/blob/master/config.json with a blurb key. Remember to get configlet and run configlet fmt . from the root of the track before submitting.

About section

If the "About" section feels a bit dry, then submit a pull request to https://github.com/exercism/powershell/blob/master/docs/ABOUT.md with suggested tweaks.

Formatting guidelines

In order to work well with the design of the new site, we're restricting the formatting of the ABOUT.md. It can use:

  • Bold
  • Italics
  • Links
  • Bullet lists
  • Number lists

Additionally:

  • Each sentence should be on its own line
  • Paragraphs should be separated by an empty line
  • Explicit <br/> can be used to split a paragraph into lines without spacing between them, however this is discouraged.

Code example

If the code example is too short or too wide or too long or too uninteresting, submit a pull request to https://github.com/exercism/ocaml/blob/master/docs/SNIPPET.txt with a suggested replacement.

Exercise metadata

Where the v1 site has a long, linear list of exercises, the v2 site has organized exercises into a small set of required exercises ("core").

If you update the track config, remember to get configlet and run configlet fmt . from the root of the track before submitting.

Topic and difficulty

Core exercises unlock optional additional exercises, which can be filtered by topic an difficulty, however that will only work if we add topics and difficulties to the exercises in the track config, which is in https://github.com/exercism/powershell/blob/master/config.json

Auto-approval

We've currently made any hello-world exercises auto-approved in the backend of v2. This means that you don't need mentor approval in order to move forward when you've completed that exercise.

Not all tracks have a hello-world, and some tracks might want to auto approve other (or additional) exercises.

Track mentors

There are no bullet points for this one :)

As we move towards the launch of the new version of Exercism we are going to be ramping up on actively recruiting people to help provide feedback. Our goal is to get to 100%: everyone who submits a solution and wants feedback should get feedback. Good feedback.

If you're interested in helping mentor the track, check out http://mentoring.exercism.io/

When all of the boxes are ticked off, please close the issue.

Tracking progress in exercism/meta#104

@gyssels
Copy link
Contributor

gyssels commented Jun 13, 2018

I'll start those next week as i'm not teaching any classes.

@gyssels gyssels self-assigned this Jun 13, 2018
@kchenery
Copy link
Contributor

I have already signed up to be a mentor for this track 😄 Looking forward to this!

@kytrinyx looking at https://v2.exercism.io/my/tracks I cannot see a track for PowerShell. Your link above (https://v2.exercism.io/tracks/powershell) does indeed take you to a PowerShell track.

@gyssels I think we should now change "Windows PowerShell" to simply "PowerShell". Might need to add some notes about Windows PowerShell v PowerShell Core. Either should be fine for the exercises so I dont see a need to push for one over the other. Maybe highlight that PowerShell Core is open sourced and will need to be manually installed. Happy to have a look at the About page for that.

@kytrinyx
Copy link
Member Author

looking at https://v2.exercism.io/my/tracks I cannot see a track for PowerShell.

@kchenery Yepp, until the track is active in the config.json it won't show up on the front page.

@gyssels
Copy link
Contributor

gyssels commented Jun 24, 2018

I tough about naming PowerShell instead of Windows PowerShell; now it's manages seriously Linux and mac os.
@kytrinyx Can you push that change?

@kytrinyx
Copy link
Member Author

@gyssels This sounds like a good chance. You can update it in the config and it should propagate:
https://github.com/exercism/powershell/blob/master/config.json#L2

@gyssels
Copy link
Contributor

gyssels commented Jun 25, 2018

Done. thanks for the remark @kchenery: The track is called now "PowerShell".

@ErikSchierboom
Copy link
Member

@Hanimn This is a good checking to verify the track's status against.

@iHiD iHiD closed this as completed May 20, 2021
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

5 participants