Skip to content

Rework gigasecond documentation #2206

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

Merged
merged 1 commit into from
Feb 24, 2023
Merged

Rework gigasecond documentation #2206

merged 1 commit into from
Feb 24, 2023

Conversation

kytrinyx
Copy link
Member

Rework gigasecond documentation

This PR is part of our project of making our Practice Exercises more consistent and human. For more context please see this forum thread

We will merge this PR in roughly 72 hours, and then submit PRs to all tracks that have this exercise.

The main changes for this exercise are:

  • Make it easier to understand
  • Make it a bit more engaging.
  • Provide more context around the idea of a gigasecond and why it is potentially interesting.
  • Tone down the mathiness in an attempt to make it feel more casual, friendly, and approachable.

This is an attempt at making the gigasecond
exercise easier to understand and a bit more
engaging.

The key change is to provide more context around
the idea of a gigasecond and why it is potentially
interesting.

It also tones down the mathiness in an attempt to
make it feel more casual, friendly, and approachable.

As part of this change we're splitting the
description.md file into two files:

- introduction.md which gives context, and
- instructions.md which tells the student what
  the task actually consists of.

This is a change that was documented as part of the v3
migration.
@habere-et-dispertire
Copy link
Contributor

Raku's default implementation includes support for leap seconds which throes the tests.

Would it be useful to mention that leap seconds are to be ignored? I know it's in the referenced JavaScript documentation for the date string as:

In time values leap seconds are ignored.

but it's rather buried. What do others think ?

@iHiD
Copy link
Member

iHiD commented Feb 23, 2023

Would it be useful to mention that leap seconds are to be ignored?

I think this is probably a track-specific thing, so it can go into the instructions.append.md file for each track. That's my instinct.

@habere-et-dispertire
Copy link
Contributor

Thanks. I tested it in a raku implementation of the gigasecond exercise.

@kytrinyx
Copy link
Member Author

Alright, it seems like we're good on this one. I'm going to go ahead and merge it, and if anyone has any further concerns, please open a PR to suggest changes.

@kytrinyx kytrinyx merged commit 5b6aedb into main Feb 24, 2023
@kytrinyx kytrinyx deleted the gigasecond-rewrite branch February 24, 2023 10:47
kytrinyx added a commit to exercism/swift that referenced this pull request Feb 24, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/perl5 that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/go that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/racket that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/nim that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/cfml that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/python that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/clojure that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
meatball133 pushed a commit to exercism/crystal that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
cmcaine pushed a commit to exercism/julia that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
rpottsoh pushed a commit to exercism/delphi that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
BethanyG pushed a commit to exercism/python that referenced this pull request Feb 27, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
glennj pushed a commit to exercism/awk that referenced this pull request Feb 28, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
glennj pushed a commit to exercism/jq that referenced this pull request Feb 28, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
glennj pushed a commit to exercism/tcl that referenced this pull request Feb 28, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
glennj pushed a commit to exercism/bash that referenced this pull request Feb 28, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
vaeng pushed a commit to exercism/cpp that referenced this pull request Mar 2, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
rainij pushed a commit to exercism/sml that referenced this pull request Mar 3, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
petertseng pushed a commit to exercism/rust that referenced this pull request Mar 6, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
dem4ron pushed a commit to dem4ron/rust-exercism that referenced this pull request Mar 9, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
dem4ron pushed a commit to dem4ron/rust-exercism that referenced this pull request Mar 9, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
fapdash pushed a commit to exercism/emacs-lisp that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/objective-c that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/perl5 that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/racket that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/cfml that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/lfe that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/dart that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/kotlin that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/php that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/scala that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/8th that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/plsql that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/groovy that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/ruby that referenced this pull request Mar 10, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
NobbZ pushed a commit to exercism/erlang that referenced this pull request Mar 14, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/babashka that referenced this pull request May 16, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
kytrinyx added a commit to exercism/d that referenced this pull request May 16, 2023
The gigasecond exercise has been overhauled as part of a project
to make practice exercises more consistent and friendly.

For more context, please see the discussion in the forum, as well as
the pull request that updated the exercise in the problem-specifications
repository:

- https://forum.exercism.org/t/new-project-making-practice-exercises-more-consistent-and-human-across-exercism/3943
- exercism/problem-specifications#2206
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

Successfully merging this pull request may close these issues.

6 participants