Skip to content

Commit 80a1931

Browse files
MerrimanIndPLeVasseur
MerrimanInd
and
PLeVasseur
authored
[All-Hands] Added README.md and presenterm template for all-hands meetings (#395)
* Added initial README.md and presenterm template slide deck * Added generated output of template slides * Update meetings/all-hands/README.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> * Update meetings/all-hands/README.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> * Update meetings/all-hands/README.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> * Update meetings/all-hands/README.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> * Update meetings/all-hands/template/all_hands-template_deck.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> * Update meetings/all-hands/template/all_hands-template_deck.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> * Update meetings/all-hands/template/all_hands-template_deck.md Co-authored-by: Pete LeVasseur <plevasseur@gmail.com> --------- Co-authored-by: Pete LeVasseur <plevasseur@gmail.com>
1 parent a329081 commit 80a1931

5 files changed

Lines changed: 482 additions & 0 deletions

File tree

‎branding/safety-critical-rust-consortium-logo-transparent.png‎

95.8 KB
Loading

‎meetings/all-hands/README.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
## Safety Critical All-Hands Meetings
2+
3+
### Purpose
4+
5+
The Safety-Critical Rust Consortium's monthly All-Hands meetings are an opportunity for Rust or general safety-critical developers to stay up-to-date with the latest news from safety-critical Rust, new tools or projects, and the activities of the consortium itself. They will also provide an opportunity for the consortium to solicit volunteers or call attention to open-source or commercial opportunities.
6+
7+
All-Hands occur monthly but rotate through three global time slots, to offer convenient times for all time zones. Due to this, each meeting will have some content overlap with the prior two given the expectation that most consortium members will attend only quarterly.
8+
9+
### Agenda
10+
11+
The agenda for each meeting is loosely grouped into:
12+
13+
1. **Quarterly Summary**
14+
A brief synopsis of topics covered in prior meetings.
15+
2. **General Rust Safety-Critical News**
16+
News from the world of safety-critical Rust such as companies adopting the language, new tools or open-source projects, or breakthroughs in implementation (new certifications, etc).
17+
3. **Subcommittee Reports**
18+
Brief updates from each of the subcommittees regarding what they've been working on or their challenges/needs from the community.
19+
4. **Calls to Action**
20+
A request for volunteers to aid in consortium activities, highlights of gaps in safety-critical tooling that are market opportunities, or requests for open-source contributors or maintainers.
21+
22+
### Process
23+
24+
The agenda for each All-Hands will be developed in Pull Requests here in the Safety-Critical Rust Consortium repo. A branch will be opened for each meeting along with a draft PR against `main`. The agenda and slides can be developed with PRs against the all-hands branch, in comments on the draft PR, or in issues for anything more general.
25+
26+
Contributors are welcome to build slides directly or suggest topics (such as a news story or tool release) that can then be integrated into the slides. Once the meeting is complete the slides will be exported to a static format and the PR will be merged into main as an archive.
27+
28+
### Slides
29+
30+
We're using [presenterm](https://github.com/mfontanini/presenterm) for the slides. This is a program (written in Rust!) that translates a markdown formatted document into a slideshow. It can either present directly within a terminal or export to files. This keeps the content directly within the repo, not as unversioned data stored in Google Slides. It allows us to develop the slide content in public and through the PR mechanism, and keeps them archived alongside the rest of the consortium content.
31+
32+
> [!NOTE]
33+
> While basic text rendering is available in all terminals, for images to be rendered inline a GPU based terminal emulator is required. Some options include [Ghostty](https://ghostty.org/) or [kitty](https://sw.kovidgoyal.net/kitty/).
34+
35+
The [presenterm docs](https://mfontanini.github.io/presenterm/) contain all the necessary information to install the tool, edit the slides, and run a presentation. But in brief:
36+
37+
1. Install from source using `cargo install --locked presenterm` or install [a built package using your OS' distro manager](https://mfontanini.github.io/presenterm/install.html).
38+
2. Edit the presentation with all markdown syntax and some additional command tags:
39+
- `<!-- end_slide -->` marks the boundary between two slides
40+
- `<!-- pause -->` sets a pause between displaying content on a single slide
41+
- `<!-- jump_to_middle -->` centers content within the middle of the slide vertically, useful for titles or subtitles
42+
3. Navigate to a directory with a markdown presentation and start the slideshow with `presenterm -p [filename.md]`.
43+
4. Alternatively the presentation can be exported to a PDF with `presenterm -e [filename.md]`. Or to an HTML document with `presenterm -E [filename.md]`.

‎meetings/all-hands/template/all_hands-template_deck.md‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: Safety-Critical Rust Consortium
3+
sub_title: All-Hands (Template)
4+
author: Xander Cesari
5+
date: 2025-08-19
6+
theme:
7+
override:
8+
footer:
9+
style: template
10+
left:
11+
image: ../../../branding/safety-critical-rust-consortium-logo-transparent.png
12+
center: '<span class="scrc">SCRC All-Hands</span> - {date}'
13+
right: "{current_slide} / {total_slides}"
14+
height: 4
15+
palette:
16+
classes:
17+
scrc:
18+
foreground: dark_grey
19+
---
20+
21+
Safety-Critical All-Hands (n-1) Summary
22+
---
23+
<!-- column_layout: [2, 1] -->
24+
<!-- column: 0 -->
25+
# Highlights:
26+
* Update 1
27+
* Update 2
28+
29+
<!-- column: 1 -->
30+
# Calls to Action:
31+
* Please contribute to this GitHub repo!
32+
33+
<!-- end_slide -->
34+
35+
Safety-Critical All-Hands (n-2) Summary
36+
---
37+
<!-- column_layout: [2, 1] -->
38+
<!-- column: 0 -->
39+
# Highlights:
40+
* Update 1
41+
* Update 2
42+
43+
<!-- column: 1 -->
44+
# Calls to Action:
45+
* Please contribute to this GitHub repo!
46+
* Join a subcommittee!
47+
48+
<!-- end_slide -->
49+
50+
News from the World of Safety-Critical Rust
51+
---
52+
* New compiler released!
53+
* KITT runs on Rust
54+
55+
<!-- end_slide -->
56+
57+
Subcomittee Report: Coding Guidelines
58+
---
59+
60+
61+
62+
<!-- end_slide -->
63+
64+
Subcomittee Report: Tooling
65+
---
66+
67+
68+
69+
<!-- end_slide -->
70+
71+
Subcomittee Report: Liaison
72+
---
73+
74+
75+
76+
<!-- end_slide -->
77+
78+
Calls to Action!
79+
---
80+
81+
82+
83+
<!-- end_slide -->

‎meetings/all-hands/template/slides/all_hands-template_deck.html‎

Lines changed: 356 additions & 0 deletions
Large diffs are not rendered by default.

‎meetings/all-hands/template/slides/all_hands-template_deck.pdf‎

100 KB
Binary file not shown.

0 commit comments

Comments
 (0)