Improve summaries of some pages, and include in the opengraph description.

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.

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

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.
-

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"
 +++

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

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."
 +++
-

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

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.

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`?

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.

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.

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."
 +++

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

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

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

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 %}