[CNCF LFX Proposal] TUF: ELI5 TUF Video and other documentation
- 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
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