Skip to content

Commit 92e4cb2

Browse files
kopporThiloteE
andauthored
Link to new board (and refine text)
Co-authored-by: ThiloteE <73715071+ThiloteE@users.noreply.github.com>
1 parent 0c96007 commit 92e4cb2

File tree

1 file changed

+21
-17
lines changed

1 file changed

+21
-17
lines changed

docs/teaching.md

+21-17
Original file line numberDiff line numberDiff line change
@@ -15,27 +15,31 @@ By using JabRef as training object in exercises and labs, students can level-up
1515

1616
## How to integrate JabRef in your class
1717

18-
1. Get in touch with the JabRef team to discuss details. We offer email, skype, [gitter.im](https://gitter.im/JabRef/jabref), discord. Get in touch with [@koppor](https://github.com/koppor/) to find the right channel and to start forming the success of your course.
19-
2. Choose tasks from one of the following boards. Write a comment on each issue so that it can be reserved for your course.
20-
* Candidates for university projects: [https://github.com/JabRef/jabref/projects/9](https://github.com/JabRef/jabref/projects/9)
21-
* This board categorizes in small, medium, and large features
22-
* Feature Board: [https://github.com/JabRef/jabref/projects/7](https://github.com/JabRef/jabref/projects/7)
23-
* This is a general feature board. Recommended, if the board above is empty or you did not find something suitable
24-
* Bug Board: [https://github.com/JabRef/jabref/projects/5](https://github.com/JabRef/jabref/projects/5)
25-
* This is an excellent board to find issues training the maintenance knowledge which is essential for industry work
26-
* General "good first issues". The JabRef team tags issues as [good first issues](https://github.com/jabref/jabref/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) to indicate open tasks offering a good start into the JabRef code. These issues are more a list of random bugs and features. For a more structured comparison of the opened tasks, we recommend the project boards listed above.
27-
* Be aware that the difficulty of bugs and feature vary. A task should be chosen with care. The JabRef team can help here: The majority of the team has experiences in teaching
18+
1. Choose task from the board [Candidates for university projects](https://github.com/orgs/JabRef/projects/3/views/3).
19+
There, new functionality is categorized in small, medium, and large effort.
20+
Morevoer, categorization on the main focus (UI, logic, or both),
21+
implementation effort, testing effort, and "issue understanding effort".
22+
The latter category is important, because some issues are "quick wins" and others need thorough thinking.
23+
In general, all issues of JabRef are free to take.
24+
Be aware that the difficulty of bugs and feature vary.
25+
For the brave, the [Bug Board](https://github.com/JabRef/jabref/projects/5) or the [Feature Board](https://github.com/JabRef/jabref/projects/7) provide other issue sources.
26+
Especially for Master students, these are excellent boards to find issues that train maintenance knowledge (which is essential for industry work).
27+
2. Get in touch with the JabRef team to reserve issues for your student group and possibly to discuss details. We offer email, skype, [gitter.im](https://gitter.im/JabRef/jabref), discord. Get in touch with [@koppor](https://github.com/koppor/) to find the right channel and to start forming the success of your course.
2828
3. Schedule tasks with students
29-
4. Code reviews by JabRef maintainers
30-
5. Students address feedback and learn more about good coding practices by incoporating feedback
31-
6. Students update their pull request
32-
7. Pull request is merged
29+
4. Students implement code
30+
5. Students review other student's code (recommended: students of a previous year's project review current year's project code)
31+
6. Students address review feedback
32+
7. Students submit pull request
33+
8. Code reviews by JabRef maintainers
34+
9. Students address feedback and learn more about good coding practices by incoporating feedback
35+
10. Students update their pull request
36+
11. Pull request is merged
3337

34-
For a near-to-perfect preparation and effect of the course, we ask you to get in touch with us **four weeks** in advance. Then, the JabRef team can a) learn about the starting skill level of the students, b) the aimed skill level at the end of the course, c) the amount of time the students are given to learn about and contribute to JabRef, d) check the [feature board](https://github.com/JabRef/jabref/projects/7) for appropriate tasks (and fill it as needed), e) recommend appropriate features.
38+
For a near-to-perfect preparation and effect of the course, we ask you to get in touch with us **four weeks** in advance. Then, the JabRef team can a) learn about the starting skill level of the students, b) the aimed skill level at the end of the course, c) the amount of time the students are given to learn about and contribute to JabRef, d) check the [Candidates for university projects](https://github.com/orgs/JabRef/projects/3/views/3) for appropriate tasks (and fill it as needed), e) recommend appropriate features.
3539

36-
It is also possible to just direct students to our [Contribution Guide](https://github.com/JabRef/jabref/blob/master/CONTRIBUTING.md#contributing-guide). The learning effect may be lower as the time of the students has to be spent to a) learn about JabRef and b) select an appropriate issue.
40+
It is also possible to just direct students to our [Contribution Guide](https://devdocs.jabref.org/contributing.html#contribute-code). The learning effect may be lower as the time of the students has to be spent to a) learn about JabRef and b) select an appropriate issue.
3741

38-
Since a huge fraction of software costs is spent on [software maintenance](https://en.wikipedia.org/wiki/Software\_maintenance), adding new features also educates in that aspect: perfective maintenance[1](teaching.md#LientzSwanson) is trained. When fixing bugs, corrective maintenance[2](teaching.md#LientzSwanson) is trained.
42+
Since a huge fraction of software costs is spent on [software maintenance](https://en.wikipedia.org/wiki/Software\_maintenance), adding new features also educates in that aspect: perfective maintenance[1](teaching.md#LientzSwanson) is trained. When fixing bugs, corrective maintenance [2](teaching.md#LientzSwanson) is trained.
3943

4044
## Process for contributions
4145

0 commit comments

Comments
 (0)