Move description under website, start removing layout: custom and adding yaml titles

Author: EllaKaye

_quarto.yml

@@ -6,6 +6,7 @@ execute:
 
 website:
   title: "R Contributor"
+  description: "A site for people interested in contributing to R core - the code and documentation that gets distributed as base R."
   site-url: https://contributor.r-project.org
   favicon: /assets/img/favicon.png
   open-graph:
@@ -21,9 +22,9 @@ website:
       - text: "Slack Group"
         file: slack.qmd
       - text: "Events"
-        file: events.qmd
+        file: events/index.qmd
       - text: "Tutorials & demos"
-        file: tutorials.qmd
+        file: tutorials/index.qmd
       - text: Working Group
         file: working-group.qmd
       - text: Resources
@@ -75,13 +76,9 @@ brand:
 
 format:
   html:
-    # theme: cosmo
-      #light: forwards-light.scss
-      #dark: forwards-dark.scss
-    #highlight-style: forwards.theme
     #css: styles.css
     link-external-newwindow: true
     toc: true  
     email-obfuscation: references
     #include-in-header: analytics.html
-    description: "A site for people interested in contributing to R core - the code and documentation that gets distributed as base R."
+    

events.qmd events/index.qmdevents.qmd renamed to events/index.qmd

@@ -1,14 +1,12 @@
 ---
-layout: custom
+title: Event calendar
 ---
 
-# Event calendar
-
 Meetings and events for existing/aspiring R contributors.
 
 ## Current events
 
-* [R Dev Days/Sprints](r-dev-days): Collaborative events to work on contributions to R or infrastructure that supports such contribution. [Google Calendar](https://calendar.google.com/calendar/embed?src=096ece8c4dd2994219c1e504a6d474f7964e16fe18eced1dbdb8d5323ee6297b%40group.calendar.google.com) / [iCal](https://calendar.google.com/calendar/ical/096ece8c4dd2994219c1e504a6d474f7964e16fe18eced1dbdb8d5323ee6297b%40group.calendar.google.com/public/basic.ics).  
+* [R Dev Days/Sprints](r-dev-days/): Collaborative events to work on contributions to R or infrastructure that supports such contribution. [Google Calendar](https://calendar.google.com/calendar/embed?src=096ece8c4dd2994219c1e504a6d474f7964e16fe18eced1dbdb8d5323ee6297b%40group.calendar.google.com) / [iCal](https://calendar.google.com/calendar/ical/096ece8c4dd2994219c1e504a6d474f7964e16fe18eced1dbdb8d5323ee6297b%40group.calendar.google.com/public/basic.ics).  
 * [R Contributor Office Hours](office-hours): monthly drop-in sessions to help people get started with contributing to R. Discuss work in progress or work together on open bugs/missing translations. [Google Calendar](https://calendar.google.com/calendar/u/0/r?cid=c7b298f30426b575f888ee963ec38a6da1ad6d2dbc27f34d501a72f2d8abb1cf@group.calendar.google.com) / [iCal](https://calendar.google.com/calendar/ical/c7b298f30426b575f888ee963ec38a6da1ad6d2dbc27f34d501a72f2d8abb1cf%40group.calendar.google.com/public/basic.ics).  
 * [C Study Group](c-study-group-2025) (February-July 2025): study group designed for R contributors to develop skills in C programming. 
 [Google Calendar](https://calendar.google.com/calendar/u/1?cid=ab59b5988cef70d576d045f33a7b4ec633d665afb070aaf696b4b353254c74dc@group.calendar.google.com) / [iCal](https://calendar.google.com/calendar/ical/ab59b5988cef70d576d045f33a7b4ec633d665afb070aaf696b4b353254c74dc%40group.calendar.google.com/public/basic.ics).

events/office-hours/index.qmd

@@ -1,13 +1,9 @@
 ---
+title: "R Contributor Office Hours"
 description: Monthly online drop-in sessions for R contributors
 image: brooke-cagle-g1Kr4Ozfoac-unsplash.jpg
-layout: custom
 ---
 
-# R Contributor Office Hours
-
-*Online drop-in sessions to support people that want to contribute to R.*
-
 <center><img src="brooke-cagle-g1Kr4Ozfoac-unsplash.jpg" alt="Three people laughing together as they sit around a table with laptops, notebooks and drinks." width="450"/></center>
 
 <br>Join an Office Hour to

events/r-dev-days/index.qmd

@@ -1,12 +1,10 @@
 ---
+title: R Dev Days
 description: Day-length events for new and experienced contributors to work collaboratively on contributions to base R
 image: dev_day1.jpg
 image-alt: R Core developer Martin Maechler working with Ella Kaye and Kelly Bodwin at an R Dev Day
-layout: custom
 ---
 
-# R Dev Days
-
 R Dev Days are short events - usually over one day, or linked sessions over 
 consecutive days - for novice and experienced contributors to work 
 collaboratively on contributions to base R. These events have the support of 

index.qmd

@@ -1,14 +1,12 @@
 ---
-layout: custom
+title: "R Contributor Site"
 ---
 
-# R Contributor Site
-
 This is a community-maintained site for people interested in contributing to core R codebase - the code and documentation that gets [distributed as base R](https://cloud.r-project.org).
 
 Join our [Slack Group](slack.qmd) to chat with current and aspiring R contributors. Everyone interested is welcome!
 
-Read the [R Development Guide](https://contributor.r-project.org/rdevguide){target="_blank"}, follow a [Tutorial](tutorials.qmd), or attend an [Event](events.qmd) to learn more about contributing to R.
+Read the [R Development Guide](https://contributor.r-project.org/rdevguide){target="_blank"}, follow a [Tutorial](tutorials/index.qmd), or attend an [Event](events/index.qmd) to learn more about contributing to R.
 
 ## Quick Start
 

r-help.qmd

@@ -1,9 +1,7 @@
 ---
-layout: custom
+title: "Resources for General Help with R"
 ---
 
-# Resources for General Help with R
-
 ## Dedicated channels for R help
 
 For help on topics that are not related to contributing to R, please post on one of the following:

slack.qmd

@@ -1,9 +1,7 @@
 ---
-layout: custom
+title: "R Contributors Slack"
 ---
 
-# R Contributors Slack
-
 The R Contributors Slack is a supportive space to foster the community of contributors to R core development:
 
 - **Potential/novice contributors** wanting support to get started/develop as contributors.

tutorials/contributing-to-r/index.qmd

@@ -1,9 +1,7 @@
 ---
-layout: custom
+title: "Contributing to R"
 ---
 
-# Contributing to R
-
 In this video tutorial recorded at useR! 2021, Gabriel Becker and Martin Maechler explain how members of the R community can contribute to R.
 
 The full video (2h15) includes Gabriel discussing his experiences as an external contributor: some of the projects he has worked on and lessons learned. This is recommended for all aspiring contributors as a window into the social dynamics of contribution.

tutorials.qmd tutorials/index.qmdtutorials.qmd renamed to tutorials/index.qmd

@@ -1,9 +1,7 @@
 ---
-layout: custom
+title: "Tutorials & Demos"
 ---
 
-# Tutorials & Demos
-
 These tutorials and demos are designed to help new contributors get started.
 
 ## Tutorials

tutorials/translating-r-to-your-language/index.qmd

@@ -1,9 +1,7 @@
 ---
-layout: custom
+title: "Translating R to your language"
 ---
 
-# Translating R to your language
-
 In this video tutorial recorded at useR! 2021, Michael Chirico and Michael Lawrence aim to get package developers and other R community members started implementing foreign-language translations of R's messages (errors, warnings, verbose output, etc.) into a language of their choosing.
 
 Our real-time participants were focused on Spanish, Bahasa Indonesia, and Hungarian.