diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 935a1f3..140366d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -147,7 +147,7 @@ python3 activities.py add 1234 --rationale "..."
...where 1234 is the GitHub issue number. Optionally also add `--description "..."` to add a description of the feature or specification.
-Alternatively, edit `activities.yml` directly.
+Alternatively, edit `activities.yml` directly. The `description` and `rationale` fields support a subset of markdown: inline code and links (URL must start with `#` or `https://`).
Then submit a pull request with the changes.
diff --git a/activities.yml b/activities.yml
index a3a47d6..b165774 100644
--- a/activities.yml
+++ b/activities.yml
@@ -1,12 +1,12 @@
's imagesrcset and imagesizes attributes:
bug: https://bugzilla.mozilla.org/show_bug.cgi?id=1515760
description: |
- Adds imagesrcset and imagesizes attributes to <link> which correspond to the srcset and sizes attributes of <img> respectively, for the purposes of preloading.
+ Adds `imagesrcset` and `imagesizes` attributes to `` which correspond to the `srcset` and `sizes` attributes of `` respectively, for the purposes of preloading.
id: image-preload
issue: 130
position: positive
rationale: |
- A relevant aspect of <link rel=preload> support.
+ A relevant aspect of `` support.
url: https://html.spec.whatwg.org/multipage/semantics.html#attr-link-imagesrcset
venues:
- WHATWG
@@ -163,7 +163,7 @@ Bundled HTTP Exchanges:
Byte Streams:
caniuse: https://caniuse.com/streams
description: |
- Byte streams are a specialization of Streams that are designed to deal with raw bytes.
+ Byte streams are a specialization of [Streams](#streams) that are designed to deal with raw bytes.
id: byte-streams
issue: 457
mdn:
@@ -291,7 +291,7 @@ CSS Painting API:
bug: https://bugzilla.mozilla.org/show_bug.cgi?id=1302328
caniuse: https://caniuse.com/css-paint-api
description: |
- An API for allowing web developers to define a custom CSS <image> with javascript, which will respond to style and size changes.
+ An API for allowing web developers to define a custom CSS `` with javascript, which will respond to style and size changes.
id: css-paint-api
issue: 1089
mdn: https://developer.mozilla.org/en-US/docs/Web/API/CSS_Painting_API
@@ -493,7 +493,7 @@ Cookie Store API:
issue: 94
position: positive
rationale: |
- This API provides better access to cookies. We are positive for a subset of this API which only exposes the same information available through document.cookie. At this time we're not ready to expose ServiceWorkerRegistration.cookies or implement the CookieStoreManager as proposed; we will discuss this along with the subset proposal in the appropriate standards group. See WICG/cookie-store issue #241.
+ This API provides better access to cookies. We are positive for a subset of this API which only exposes the same information available through document.cookie. At this time we're not ready to expose ServiceWorkerRegistration.cookies or implement the CookieStoreManager as proposed; we will discuss this along with the subset proposal in the appropriate standards group. See [WICG/cookie-store issue #241](https://github.com/WICG/cookie-store/issues/241).
url: https://wicg.github.io/cookie-store/
venues:
- Proposal
@@ -541,7 +541,7 @@ Cross-Origin Read Blocking (CORB):
issue: 81
position: neutral
rationale: |
- While this is an important aspect of a robust Spectre-defense, we would like to see a safelist-based approach pursued, e.g., Opaque Response Blocking.
+ While this is an important aspect of a robust Spectre-defense, we would like to see a safelist-based approach pursued, e.g., [Opaque Response Blocking](https://github.com/annevk/orb).
url:
https://chromium.googlesource.com/chromium/src/+/master/services/network/cross_origin_read_blocking_explainer.md
venues:
@@ -706,7 +706,7 @@ First-Party Sets:
issue: 350
position: negative
rationale: |
- We believe the definition of first party should be clear and understandable to users, web developers, and publishers, and thus ideally it should be based only on the top-level URL. While we can't quite do that today because it isn't compatible with all sites, we'd like to move towards doing that, rather than standardizing a mechanism that moves away from that. See more details.
+ We believe the definition of first party should be clear and understandable to users, web developers, and publishers, and thus ideally it should be based only on the top-level URL. While we can't quite do that today because it isn't compatible with all sites, we'd like to move towards doing that, rather than standardizing a mechanism that moves away from that. See [more details](https://github.com/privacycg/proposals/issues/17#issuecomment-641687052).
url: https://github.com/WICG/first-party-sets
venues:
- Proposal
@@ -729,7 +729,7 @@ Fragmention:
issue: 234
position: positive
rationale: |
- We feel that some of the use cases this proposal addresses are very important to address, but worry about the lack of a clear processing model and about possible compat constraints that may need implementation experience to fully understand. More details are in the position issue. See also the position on Scroll to Text Fragment, which aims to address similar use cases.
+ We feel that some of the use cases this proposal addresses are very important to address, but worry about the lack of a clear processing model and about possible compat constraints that may need implementation experience to fully understand. More details are in the position issue. See also the [position on Scroll to Text Fragment](#scroll-to-text-fragment), which aims to address similar use cases.
url: https://indieweb.org/fragmention
venues:
- Proposal
@@ -806,7 +806,7 @@ HTML Modules:
HTML autofocus attribute overhaul:
bug: https://bugzilla.mozilla.org/show_bug.cgi?id=1574435
description: |
- Overhaul the autofocus processing model to better match browser behavior, fit better within the specification ecosystem, and avoid bad results for users.
+ Overhaul the `autofocus` processing model to better match browser behavior, fit better within the specification ecosystem, and avoid bad results for users.
id: autofocus-overhaul
issue: 195
position: positive
@@ -817,7 +817,7 @@ HTMLVideoElement.requestVideoFrameCallback():
bug: https://bugzilla.mozilla.org/show_bug.cgi?id=1800882
caniuse: https://caniuse.com/mdn-api_htmlvideoelement_requestvideoframecallback
description: |
- <video>.requestVideoFrameCallback() allows web authors to be notified when a frame has been presented for composition.
+ `