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
servo · Feb 19, 2025 · d2cdbd8 · d2cdbd8
1 parent cb0097c
commit d2cdbd8
Show file tree

Hide file tree

Showing 4 changed files with 203 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -28,6 +28,12 @@ $ rm tools/runs.json  # Optional: clear CI history cache
 $ tools/list-commits-by-nightly.sh /path/to/servo
 ```
 
+To copy the output to your clipboard for a specific calendar month only:
+
+```sh
+$ tools/list-commits-by-nightly.sh ~/code/servo 2>&1 | tee /dev/stderr | sed '/^>>> 2025-01-/,/^>>> 2025-02-/!d' | xclip -sel clip
+```
+
 ## How to list this year’s pull request contributors
 
 ```sh
@@ -347,6 +353,17 @@ And generally we want to exclude...
 - refactors (unless large-scale)
 - dependency cleanups
 
+The suggested workflow for efficiently triaging commits is as follows:
+
+- [List commits that landed in each nightly](#how-to-list-commits-that-landed-in-each-nightly) last month, copying the output to your clipboard
+- In your monthly update post, paste that output between a `<!--[commits]` line and a `[/commits]-->` line
+- 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))
+- For each commit to be excluded from the post, prefix the line with `-`
+- For each commit to be included in the post, prefix the line with `+` then:
+    - Add a line immediately below of the form `    one or more tags` (four spaces, then space-separated tags)
+    - To write some notes or additional context, append `; your notes` to that new tags line
+- Generate the outline: `tools/generate-outline.sh _posts/xxxx-xx-xx-this-month-in-servo.md`
+
 ## Hints for writing about changes
 
 **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/)).