Add prerequisites to Practice Exercises
还没有人认领这个 Issue。
评估
调研方向
首先定位 PHP track 的 config.json,并将其中的 exercises.practice 条目与链接的 practice-exercises 和 concepts 规范进行比较。使用现有的 topics 值作为线索,然后更新 practices 和 prerequisites,在顶层添加相应的 concepts 条目,并在定义了 prerequisites 的地方删除 topics。完成的标准是每个 Practice Exercise 都具有所需的元数据,并且配置与规范一致。
由索引模型根据 Issue 内容生成。
描述
This issue is part of the migration to v3. You can read full details about the various changes here.
Exercism v3 introduces a new type of exercise: Concept Exercises. All existing (V2) exercises will become Practice Exercises.
Concept Exercises and Practice Exercises are linked to each other via Concepts. Concepts are taught by Concept Exercises and practiced in Practice Exercises. Each Exercise (Concept or Practice) has prerequisites, which must be met to unlock an Exercise - once all the prerequisite Concepts have been "taught" by a Concept Exercise, the exercise itself becomes unlocked.
For example, in some languages completing the Concept Exercises that teach the "String Interpolation" and "Optional Parameters" concepts might then unlock the two-fer Practice Exercise.
Each Practice Exercise has two fields containing concepts: a practices field and a prerequisites field.
Practices
The practices key should list the slugs of Concepts that this Practice Exercise actively allows a student to practice.
- These show up in the UI as "Practice this Concept in: TwoFer, Leap, etc"
- Try and choose 3 - 8 Exercises that practice each Concept.
- Try and choose at least two Exercises that allow someone to practice the basics of a Concept.
- Some Concepts are very common (for example
strings). In those cases we recommend choosing a few good exercises that make people think about those Concepts in interesting ways. For example, exercises that require UTF-8, string concatenation, char enumeration, etc, would all be good examples. - There should be one or more Concepts to practice per exercise.
Prerequisites
The prerequisites key lists the Concept Exercises that a student must have completed in order to access this Practice Exercise.
- These show up in the UI as "Learn Strings to unlock TwoFer"
- It should include all Concepts that a student needs to have covered to be able to complete the exercise in at least one idiomatic way. For example, for the TwoFer exercise in Ruby, prerequisites might include
strings,optional-params,implicit-return. - For Exercises that can be completed using alternative Concepts (e.g. an Exercise solvable by
loopsorrecursion), the maintainer should choose the one approach that they would like to unlock the Exercise, considering the student's journey through the track. For example, the loops/recursion example, they might think this exercise is a good early practice ofloopsor that they might like to leave it later to teach recursion. They can also make use of an analyzer to prompt the student to try an alternative approach: "Nice work on solving this via loops. You might also like to try solving this using Recursion." - There should be one or more prerequisites Concepts per exercise.
Although ideally all Concepts should be taught by Concept Exercises, we recognise that it will take time for tracks to achieve that. Any Practice Exercises that have prerequisites which are not taught by Concept Exercises, will become unlocked once the final Concept Exercise has been completed.
Goal
Practices
The "practices" field of each element in the "exercises.practice" field in the config.json file should be updated to contain the practice concepts. See the spec.
To help with identifying the practice concepts, the "topics" field can be used (if it has any contents). Once prerequisites have been defined for a Practice Exercise, the "topics" field should be removed.
Each practice concept should have its own entry in the top-level "concepts" array. See the spec.
Prerequisites
The "prerequisites" field of each element in the "exercises.practice" field in the config.json file should be updated to contain the prerequisite concepts. See the spec.
To help with identifying the prerequisites, the "topics" field can be used (if it has any contents). Once prerequisites have been defined for a Practice Exercise, the "topics" field should be removed.
Each prerequisite concept should have its own entry in the top-level "concepts" array. See the spec.
Example
{
"exercises": {
"practice": [
{
"uuid": "8ba15933-29a2-49b1-a9ce-70474bad3007",
"slug": "leap",
"name": "Leap",
"practices": ["if-statements", "numbers", "operator-precedence"],
"prerequisites": ["if-statements", "numbers"],
"difficulty": 1
}
]
}
}
Tracking
- 主要语言
- PHP
- 星标
- 167
- 派生
- 151
- 平均合并
- 2 天 6 小时
- 30 天内合并 PR
- 8
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
exercism/php 的其他 Issue
-
Streamline `contribution` commands可能已有人在做 @homersimpsons 于 13 天前认领。 未关闭x:knowledge/advanced x:module/generator x:status/claimed x:type/coding
-
难度 5/5 一周以上 新手友好度 20/100
-
难度 5/5 一周以上 新手友好度 25/100
-
难度 4/5 3-5 天 新手友好度 35/100
-
Discussion: Test generator design可能重新可做 @mk-mxp 于 412 天前认领,目前没有进行中的 PR。 未关闭
相似的 Issue
-
dependencies enhancement
难度 2/5 1-3 小时 新手友好度 68/100
novalo-dev/Prestashop-MCP-Server#329 ·
维护者通常 1 天内回复
-
sync-en
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
sync-en
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
Перевод устарел
难度 1/5 1 小时以内 新手友好度 78/100
维护者通常 1 天内回复
-
CalDAV PUT: with SABRE_MAX_RECURRENCES negative, a dense COUNT-bounded RRULE (e.g. FREQ=HOURLY from year 1015) makes CalendarDataNormalizer walk millions of instances up to 2038, holding the request for tens of seconds or more可能已有人在做 @chibenwa 今天认领。 未关闭ai-driven-fuzzing bug claude Major
难度 2/5 1-3 小时 新手友好度 72/100
linagora/esn-sabre#877 · 1 条评论 ·
维护者通常 1 天内回复