Skip to content

Commit d2cdbd8

Browse files
authored
blog: This month in Servo (January 2025) (#213)
* blog: This month in Servo (January 2025) * Triage all remaining commits * Generate outline (ty for the idea @the6p4c) * Fix triage for a couple of commits * Write about new API support * Write about embedding * Update the outline * Write about prefs * Write about shadow DOM * Write about script * Write about table layout * Write about donations * Write about crashes * Fix false positives when one tag is a prefix of another * Write about devtools * Update tables * Write about networking * Write about CI * Write about conference talks * Fix wpt.fyi link * Clarify that <slot> layout lands in February * Add figure * Title, summary, and date * Remove notes * Linkify everything * Fix alt text
1 parent cb0097c commit d2cdbd8

File tree

4 files changed

+203
-0
lines changed

4 files changed

+203
-0
lines changed

README.md

+17
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,12 @@ $ rm tools/runs.json # Optional: clear CI history cache
2828
$ tools/list-commits-by-nightly.sh /path/to/servo
2929
```
3030

31+
To copy the output to your clipboard for a specific calendar month only:
32+
33+
```sh
34+
$ tools/list-commits-by-nightly.sh ~/code/servo 2>&1 | tee /dev/stderr | sed '/^>>> 2025-01-/,/^>>> 2025-02-/!d' | xclip -sel clip
35+
```
36+
3137
## How to list this year’s pull request contributors
3238

3339
```sh
@@ -347,6 +353,17 @@ And generally we want to exclude...
347353
- refactors (unless large-scale)
348354
- dependency cleanups
349355

356+
The suggested workflow for efficiently triaging commits is as follows:
357+
358+
- [List commits that landed in each nightly](#how-to-list-commits-that-landed-in-each-nightly) last month, copying the output to your clipboard
359+
- In your monthly update post, paste that output between a `<!--[commits]` line and a `[/commits]-->` line
360+
- For each commit, click on the link to read more and understand its impact (see [§ Hints for writing about changes](#hints-for-writing-about-changes))
361+
- For each commit to be excluded from the post, prefix the line with `-`
362+
- For each commit to be included in the post, prefix the line with `+` then:
363+
- Add a line immediately below of the form ` one or more tags` (four spaces, then space-separated tags)
364+
- To write some notes or additional context, append `; your notes` to that new tags line
365+
- Generate the outline: `tools/generate-outline.sh _posts/xxxx-xx-xx-this-month-in-servo.md`
366+
350367
## Hints for writing about changes
351368

352369
**Always check the correct names of people and API features.** People like it when their names are spelled correctly, of course, but sometimes authors refer to API features by incorrect names. When in doubt, check the spec. For example, [servo#32642](https://github.com/servo/servo/pull/32642) says “ShaderCompilationInfo” in the title, but the interface is actually [GPUCompilationInfo](https://developer.mozilla.org/en-US/docs/Web/API/GPUCompilationInfo), returned by the [getCompilationInfo() method on GPUShaderModule](https://developer.mozilla.org/en-US/docs/Web/API/GPUShaderModule/getCompilationInfo) ([July 2024](https://servo.org/blog/2024/07/31/this-month-in-servo/)).

0 commit comments

Comments
 (0)