From 8d485c29ac90de01d86af011f34d3ff7ce7a867f Mon Sep 17 00:00:00 2001 From: Half-Shot Date: Mon, 11 May 2026 17:19:31 +0100 Subject: [PATCH 1/2] Use page summary for opengraph description. Signed-off-by: Will Hunt --- templates/skel.html | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/templates/skel.html b/templates/skel.html index 680b0b224..7aedd21a4 100644 --- a/templates/skel.html +++ b/templates/skel.html @@ -27,6 +27,10 @@ {% set og_description = page.extra.meta_description %} {% elif section.extra.meta_description %} {% set og_description = section.extra.meta_description %} + {% elif page.extra.summary %} + {% set og_description = page.extra.summary %} + {% elif section.extra.summary %} + {% set og_description = section.extra.summary %} {% else %} {% set og_description = "Matrix, the open protocol for secure decentralised communications" %} {% endif %} From df4978a22734669b49cde231d5f4ad35691ddfc1 Mon Sep 17 00:00:00 2001 From: Half-Shot Date: Mon, 11 May 2026 17:19:52 +0100 Subject: [PATCH 2/2] Best effort summarisation. Signed-off-by: Will Hunt --- content/branding.md | 1 + content/contact.md | 1 + content/foundation/working-groups/events.md | 2 +- content/foundation/working-groups/governance.md | 1 + content/foundation/working-groups/room-directory.md | 1 + .../working-groups/trust-safety-research-documentation.md | 2 +- content/foundation/working-groups/website-content.md | 1 + content/homeserver/about.md | 1 + content/homeserver/official.md | 1 + content/homeserver/pricing.md | 1 + content/homeserver/room_directory.md | 1 + content/jobs/_index.md | 1 + content/security-disclosure-policy.md | 1 + content/security-hall-of-fame/index.md | 1 + content/twim-guide.md | 1 + 15 files changed, 15 insertions(+), 2 deletions(-) diff --git a/content/branding.md b/content/branding.md index 70f070f05..b27b77965 100644 --- a/content/branding.md +++ b/content/branding.md @@ -1,6 +1,7 @@ +++ title = "Branding & Assets" template = "branding.html" +extra.summary = "Branding and Assets for matrix.org" +++ These badges are available for **members of The Matrix.org Foundation** to showcase their support for the ecosystem. Whether you are an Associate, Ecosystem, Individual, Silver, Gold, or Platinum member, you can use these assets on your website, GitHub profiles, or marketing materials. diff --git a/content/contact.md b/content/contact.md index 82c2030f2..4755f658e 100644 --- a/content/contact.md +++ b/content/contact.md @@ -1,5 +1,6 @@ +++ title = "Contact" +extra.summary = "The best place to get information and connect is on Matrix itself - starting in #matrix:matrix.org or in the #foundation-office:matrix.org" +++ The best place to get information and connect is on Matrix itself - starting in diff --git a/content/foundation/working-groups/events.md b/content/foundation/working-groups/events.md index 0d76a1dc9..e167b99e1 100644 --- a/content/foundation/working-groups/events.md +++ b/content/foundation/working-groups/events.md @@ -1,6 +1,7 @@ +++ title = "Events WG" template = "governing-board/working_group.html" +extra.summary = "Information about the Matrix.org Events Working Group" +++ ## Activities @@ -37,4 +38,3 @@ If you have an event you're organizing and want listed in the space, you should Please reach out to the WG via its Matrix room [#events-wg:matrix.org](https://matrix.to/#events-wg:matrix.org) or privately by email to [events-wg@foundation.matrix.org](mailto:events-wg@foundation.matrix.org). The Events WG will check against the policy and notify you about the decision to include it or not. WG decisions may be overruled by the Foundation's Trust & Safety team. - diff --git a/content/foundation/working-groups/governance.md b/content/foundation/working-groups/governance.md index a62b80267..18e71823f 100644 --- a/content/foundation/working-groups/governance.md +++ b/content/foundation/working-groups/governance.md @@ -1,4 +1,5 @@ +++ title = "Governance WG" template = "governing-board/working_group.html" +extra.summary = "Information about the Matrix.org Governance Working Group" +++ diff --git a/content/foundation/working-groups/room-directory.md b/content/foundation/working-groups/room-directory.md index e6d3e8186..72664a3fd 100644 --- a/content/foundation/working-groups/room-directory.md +++ b/content/foundation/working-groups/room-directory.md @@ -1,6 +1,7 @@ +++ title = "Room Directory WG" template = "governing-board/working_group.html" +extra.summary = "This working group's primary purpose is receiving and processing requests about the room directory of the matrix.org homeserver." +++ ## Activities diff --git a/content/foundation/working-groups/trust-safety-research-documentation.md b/content/foundation/working-groups/trust-safety-research-documentation.md index 691b5206a..c493f2dde 100644 --- a/content/foundation/working-groups/trust-safety-research-documentation.md +++ b/content/foundation/working-groups/trust-safety-research-documentation.md @@ -1,5 +1,5 @@ +++ title = "Trust & Safety Research & Documentation WG" template = "governing-board/working_group.html" +extra.summary = "Information about the Matrix.org Trust & Safety Research & Documentation Working Group." +++ - diff --git a/content/foundation/working-groups/website-content.md b/content/foundation/working-groups/website-content.md index 17e110b99..a0799e139 100644 --- a/content/foundation/working-groups/website-content.md +++ b/content/foundation/working-groups/website-content.md @@ -1,6 +1,7 @@ +++ title = "Website & Content WG" template = "governing-board/working_group.html" +extra.summary = "Information about the Matrix.org Website & Content Working Group." +++ ## Activities diff --git a/content/homeserver/about.md b/content/homeserver/about.md index 37866c7b6..fa281972c 100644 --- a/content/homeserver/about.md +++ b/content/homeserver/about.md @@ -3,6 +3,7 @@ title = "The Matrix.org Homeserver" aliases = ["/homeserver"] insert_anchor_links = "left" weight = 0 +extra.summary = "The public Matrix network is a federated network of Matrix 'homeservers', in which users of one Matrix homeserver can communicate with users of another Matrix homeserver." +++ The public Matrix network is a federated network of Matrix "homeservers", in which users of one Matrix homeserver can communicate with users of another Matrix homeserver. diff --git a/content/homeserver/official.md b/content/homeserver/official.md index 14701dc77..206c0a492 100644 --- a/content/homeserver/official.md +++ b/content/homeserver/official.md @@ -1,6 +1,7 @@ +++ title = "Matrix.org (Official Account)" weight = 10 +extra.summary = "The Matrix.org Foundation uses `@server:matrix.org` to message users on the matrix.org homeserver. It is a special account, used to send information from the server to registered users." +++ ## Who is the Matrix.org (Official Account) `@server:matrix.org`? diff --git a/content/homeserver/pricing.md b/content/homeserver/pricing.md index 3ba7f290a..57adb36be 100644 --- a/content/homeserver/pricing.md +++ b/content/homeserver/pricing.md @@ -1,6 +1,7 @@ +++ title = "Matrix.org Homeserver Pricing" weight = 20 +extra.summary = "The Foundation provides the public matrix.org homeserver as an easy entry point for those wanting to create their first Matrix account and join the network. To help pay for the costs associated with providing a public homeserver, the Foundation is introducing premium accounts" +++ One of the missions of The Matrix.org Foundation is to nurture and grow the ecosystem and the network. To support this mission, the Foundation provides the public matrix.org homeserver as an easy entry point for those wanting to create their first Matrix account and join the network. The matrix.org homeserver has played a key role in the growth of the ecosystem since the project started in 2014. diff --git a/content/homeserver/room_directory.md b/content/homeserver/room_directory.md index 543d2fb63..461ee617e 100644 --- a/content/homeserver/room_directory.md +++ b/content/homeserver/room_directory.md @@ -1,6 +1,7 @@ +++ title = "Matrix.org Room Directory" weight = 30 +extra.summary = "The published room directory of a Matrix homeserver is a great way to discover rooms and spaces." +++ The published room directory of a Matrix homeserver is a great way to discover rooms and spaces. It’s often the starting point for new users who want to explore the network. diff --git a/content/jobs/_index.md b/content/jobs/_index.md index 6ea261ead..e2551ee4f 100644 --- a/content/jobs/_index.md +++ b/content/jobs/_index.md @@ -3,4 +3,5 @@ title = "Jobs" template = "jobs.html" sort_by = "date" insert_anchor_links = "left" +extra.summary = "Job postings for roles within the Matrix.org Foundation." +++ diff --git a/content/security-disclosure-policy.md b/content/security-disclosure-policy.md index e6070bdd4..c41b2848d 100644 --- a/content/security-disclosure-policy.md +++ b/content/security-disclosure-policy.md @@ -1,5 +1,6 @@ +++ title = "Security Disclosure Policy" +extra.summary = "Matrix.org greatly appreciates investigative work into security vulnerabilities carried out by well-intentioned, ethical security researchers." +++ Matrix.org greatly appreciates investigative work into security vulnerabilities diff --git a/content/security-hall-of-fame/index.md b/content/security-hall-of-fame/index.md index 2f3d9f861..7b79258f6 100644 --- a/content/security-hall-of-fame/index.md +++ b/content/security-hall-of-fame/index.md @@ -2,6 +2,7 @@ title = "Security Hall of Fame" template = "security-hall-of-fame.html" aliases = ["/hall-of-fame"] +extra.summary = "Here we maintain a list of security researchers and their findings, to recognize them for having responsibly disclosed security issues to us in the past." +++ Here we maintain a list of security researchers and their findings, to recognize diff --git a/content/twim-guide.md b/content/twim-guide.md index 23c6f4c37..f8f72f03f 100644 --- a/content/twim-guide.md +++ b/content/twim-guide.md @@ -1,5 +1,6 @@ +++ title = "Writing a good \"This Week in Matrix\" entry" +extra.summary = "This Week in Matrix (TWIM) is a weekly digest on the blog. There are some guidelines you should be aware of before publishing your update to TWIM." +++ This Week in Matrix (TWIM) is a weekly digest on the blog in which