Repository navigation
docs: Introduce new concept for TemporalAdjusters - #2944
Conversation
|
Ah, I noticed you've moved the meetup exercise to a concept exercise. We shouldn't be doing that because it is a practice exercise, with a problem spec in the problem-specifications repo (so the tests are shared across the tracks). Instead, we should come up with another concept exercise to introduce temporal adjusters. For the concept exercise, we'll need to choose a background story. For example, we're using Booking Up For Beauty for Local Date/Time. For temporal adjusters, C# also uses Beauty Salon Goes Global - we could probably do the same. Alternatively, we could also look through the list to see what other stories are used. We should also add |
Thank you for your suggestion. To be honest, I was also thinking about a special exercise. It take some time :) |
|
@rabestro Is this something you're still working on? |
Thanks for pinging me. |
Introduces the `Temporal Adjusters` concept, including an overview, examples, and links for Java's `TemporalAdjuster` and `TemporalAdjusters` utilities. Updates `config.json` to include the concept and a new exercise, "Meetup," with relevant prerequisites.
Simplify the introduction and examples for `TemporalAdjusters` to improve clarity and focus on practical use cases. Removed redundant examples and reorganized sections to prioritize key adjusters like ordinal days and "teenth" date calculations. Enhanced consistency and readability across code snippets and explanations.
Adjusted the `blurb` text for clarity and reformatted the `authors` field for improved readability. These changes maintain consistency with JSON coding standards and enhance the file's maintainability.
Replaced asterisks with dashes for consistency in list formatting and added blank lines for better readability. These changes improve the overall structure and clarity of the documentation.
Standardize heading levels for consistency and readability. Changed `###` to `##` in multiple sections to align with the document's structure. No content modifications were made.
The links to LocalDate and DayOfWeek documentation were unused and have been removed to improve clarity and maintainability. This helps keep the documentation clean and focused.
e76ec25 to
32c74e7
Compare
|
Rebased on |
The concept exercise asks students to write a TemporalAdjuster of their own, so the introduction shown before the exercise needs to cover it. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
A sequel to booking-up-for-beauty that teaches the temporal-adjusters concept: standing appointments for regular clients (dayOfWeekInMonth, lastInMonth, nextOrSame), the month-end bookkeeping day (lastDayOfMonth, previous) and a reusable custom adjuster for the weekend rule. Also adds temporal-adjusters as a prerequisite of the meetup practice exercise, as requested in review. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Added a concept exercise for the concept, |
- Put each sentence on its own line in about.md and introduction.md - Drop the paragraph and section that hint at the Meetup practice exercise; introduce next()/previous()/nextOrSame() on their own instead - Point Javadoc links in about.md, links.json and the exercise hints to Java 25 - Regenerate the exercise introduction from the updated concept Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Thanks for the review! Addressed in 658421b: each sentence now starts on a new line in |
kahgoh
added
the
ready-to-translate
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
This PR has been translated 🚀 |
pull request
Description
This PR introduces a new concept, "TemporalAdjusters", to the Java track's syllabus.
Motivation:
It has been observed (e.g., during mentoring for the
Meetupexercise) that many students are unfamiliar with thejava.time.temporal.TemporalAdjusterinterface and the associatedTemporalAdjustersutility class. This often leads to complex manual date calculations instead of leveraging these powerful and idiomatic standard library features.Solution:
This PR adds a dedicated concept to explain
TemporalAdjusters, covering:.with()method.TemporalAdjustersclass (e.g.,dayOfWeekInMonth,lastInMonth,nextOrSame).java.time.The following files have been created for this concept:
concepts/temporal-adjusters/about.mdconcepts/temporal-adjusters/introduction.mdconcepts/temporal-adjusters/links.jsonUUID:
cc7a06d1-ddb3-4722-88a5-f762254d664eThe concept has also been added to the track's main configuration file using the UUID above.
Goal:
By introducing this concept, we aim to guide students towards using
TemporalAdjustersearlier, enabling them to write more idiomatic and robust solutions for date-related exercises.Closes #2937
Reviewer Resources:
Track Policies