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

Implement New Concept Exercise: Channels and Select #2182

Open
Tracked by #1886
andrerfcsantos opened this issue Apr 13, 2022 · 5 comments
Open
Tracked by #1886

Implement New Concept Exercise: Channels and Select #2182

andrerfcsantos opened this issue Apr 13, 2022 · 5 comments
Labels
x:action/create Work on something from scratch x:knowledge/intermediate Quite a bit of Exercism knowledge required x:module/concept Work on Concepts x:module/concept-exercise Work on Concept Exercises x:rep/large Large amount of reputation x:size/large Large amount of work x:type/content Work on content (e.g. exercises, concepts)

Comments

@andrerfcsantos
Copy link
Member

andrerfcsantos commented Apr 13, 2022

Getting Started

If you have not yet contributed to concept exercises before, this task requires some upfront reading to acquire the necessary background knowledge.

Here you can read about what Concept Exercises are and how they are structured:

Also, be aware of these general guidelines:

Goal

The goal here is to create a new concept exercise that teaches about channels and select.
That includes writing a concept and creating a new exercise.

Concepts

The following concept needs to be created:

  • channels

You can use the introduction.md file of the concept also as introduction.md file of the exercise. No need to create different content at this point. Additionally, if you want to save some time it is ok to not have an extensive about.md at this point. It can also be mainly the instructions.md content, maybe with some additions you would like to make.

Learning Objectives

The student should learn about the following topics and then practice them in the concept exercise:

  • understand what channels are
  • using channels as a way to synchronize goroutines
  • the difference between buffered and unbuffered channels
  • closing channels
  • for loop over a channel: for x := range ch { ... }
  • use select to receive from several channels

Prerequisites

  • functions
  • for-loops
  • range-iteration
    Additionally, it can be assumed the student already knows goroutines.

These prerequisites should be listed in the config.json entry for the exercise.
The prerequisites above are a baseline of the prerequisites that might be needed for the exercise.
When implementing the exercise, feel free to add more prerequisites if the exercise needs them.

Story

Try to think of a story for the exercise that ties all the tasks together.
The story doesn't need to be highly complex.
Even a small story goes a long way to improve the enjoyment of the exercise.

See https://exercism.org/docs/building/tracks/stories for inspiration.

Resources

Some links that might be helpful as a starting point and/or for the links section of the concept:

How to proceed

  1. First accept this issue by saying "I'd like to work on this" (no need to wait for a response, just go ahead).
  2. Use this issue to discuss any questions you have, what should be included in the content and whatnot, and to collect more reference material.
  3. Create a PR and set "exercism/go" as reviewers. Additionally, you can write in #maintaining-go on Slack that your PR is ready for review. Once you incorporated any critical feedback that the reviewer might give you and the PR is approved, it will be merged by a maintainer.
@andrerfcsantos andrerfcsantos added x:action/create Work on something from scratch x:knowledge/intermediate Quite a bit of Exercism knowledge required x:module/concept Work on Concepts x:module/concept-exercise Work on Concept Exercises x:type/content Work on content (e.g. exercises, concepts) x:size/large Large amount of work labels Apr 13, 2022
@ErikSchierboom ErikSchierboom added x:size/large Large amount of work and removed x:size/large Large amount of work labels Apr 26, 2022
@junedev junedev added the x:rep/large Large amount of reputation label Apr 27, 2022
@RezaSi

This comment was marked as outdated.

@junedev junedev added the x:status/claimed Someone is working on this issue label Jul 15, 2022
@junedev
Copy link
Member

junedev commented Jul 16, 2022

@RezaSi I discussed with @andrerfcsantos and we decided that it is fine for this exercise to assume that the student already knows goroutines. So when you move on to creating the exercise, goroutines can be included. I adjusted the description above accordingly.

@RezaSi

This comment was marked as outdated.

@junedev

This comment was marked as outdated.

@junedev junedev linked a pull request Aug 17, 2022 that will close this issue
@junedev junedev removed the x:status/claimed Someone is working on this issue label Oct 1, 2022
@Azanul
Copy link

Azanul commented Jul 4, 2023

May I work on this issue?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
x:action/create Work on something from scratch x:knowledge/intermediate Quite a bit of Exercism knowledge required x:module/concept Work on Concepts x:module/concept-exercise Work on Concept Exercises x:rep/large Large amount of reputation x:size/large Large amount of work x:type/content Work on content (e.g. exercises, concepts)
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants