cncf / cncf/mentoring

[CNCF LFX Proposal] TUF: ELI5 TUF Video and other documentation

Open
#2,028 15 comments 0 reactions 0 assignees View on GitHub
2026 CNCF Approved Exported lfx mentorship Maintainer/Contribex Approved Mentors Confirmed Proposal Term 3: Sept-Nov Validation Passed
Dominant language
JavaScript
Stars
3.1k
Forks
816
Avg merge
12h 32m
Merged PRs (30d)
8

Description

### CNCF Project

The Update Framework (TUF)

### Term

2026 Term 3 (Sep-Nov)

### Program Name

Add ELI5 documentation / video to TUF

### Program Description

## Description

We've heard from some potential adopters that TUF is hard to understand. We'd like to remedy this by making documentation accessible to a five year old (ELI5). We can be flexible about whether the end result is video, web site documentation, a children's book, or other format.

We'd like this to be quality tested within our community and with outside users to ensure this is effective. So, you should be prepared to do this iteratively and test feedback.

## Expected Outcomes

- at least one form of deliverable (documentation, video, etc.) which has been validated internally and externally through an iterative process
- integration of the deliverable into the TUF website
- dissemination of the deliverable via appropriate means (LF socials, presentation at an LF event, etc.)

### Technologies

TUF

### Skills same as Technologies?

- [ ] Yes, the required skills are the same as the technologies listed above.

### Required/Desirable Skills

technical writing skills, presentation skills, video editing, storyboarding, etc.

### Mentors

Justin Cappos | @JustinCappos | jcappos@nyu.edu | justincappos
Kairo de Araujo | @kairoaraujo | kairo@dearaujo.nl | kairoaraujo

### Upstream Issue URL

https://github.com/theupdateframework/theupdateframework.io/issues/132

### Application Prerequisites

- [x] Resume
- [x] Cover Letter
- [ ] School Enrollment Verification
- [ ] Participation Permission from school or employer
- [ ] Coding Challenge
- [x] Custom Prerequisite (fill in details below)

### Coding Challenge URL

_No response_

### Custom Prerequisite Name

Portfolio

### Custom Prerequisite Description

Please upload samples that show similar work you have done.

### Custom Prerequisite — File Upload

- [x] Yes — completion of this task requires the mentee to submit a file.

---
**LFX program:** [CNCF - The Update Framework (TUF): Add ELI5 documentation / video to TUF (2026 Term 3)](https://mentorship.lfx.linuxfoundation.org/project/514edf13-be1b-4b3c-a71c-2cacd81c9c8e)

Contributor guide

Open the contributing guide

Research direction

Start with the upstream TUF website issue at https://github.com/theupdateframework/theupdateframework.io/issues/132 and review the existing TUF website documentation. Define the deliverable format with the mentors, then plan internal and external feedback cycles. Done means a validated ELI5 deliverable is integrated into the TUF website and disseminated through the stated channels.

Written by the indexing model from the issue text.

Assessment

Domain
content, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.