Skip to content

Conversation

@gnd8596
Copy link

@gnd8596 gnd8596 commented Dec 18, 2025

Checklist

This pull request adds a structured glossary of core FFmpeg and digital preservation terms, embeds glossary links throughout ffmprovisr, and introduces several real-world case scenarios illustrating common FFmpeg uses.

Changes include:

  • A new glossary with definitions, context, and references
  • Embedded glossary links across existing recipes
  • Case scenarios broken into context, solution, and outcome
  • Documentation for GUI-based tools (Shutter Encoder, XLD, and HandBrake) to support users with limited command-line experience

This work was informed by interviews with moving image preservation professionals and aims to lower barriers to entry for students and small institutions.

chocolatti and others added 30 commits November 20, 2025 20:05
Added a glossary section with definitions and examples for technical terms related to codecs. Started Codec and add an anchor link to Codec Defaults section
Add event listener for hash link clicks to toggle visibility of hidden sections.
Added bibliography and video codec section to FLAC entry.
Updated glossary section with detailed codec descriptions and added bibliographic references.
Updated the description of the transcoding command to include a hyperlink for Apple ProRes 422.
Added information about Shutter Encoder and fixed a typo.
@kfrn
Copy link
Member

kfrn commented Dec 22, 2025

Hello! This looks really good, but is there any chance that you could tidy it up into discrete commits for easier reviewing? e.g. one commit per new recipe/entry/change

Edit: recommend something like this:

# Make sure you have the latest gh-pages branch (prob the case already, just being thorough here)
git fetch --all

# Remove your commits but keep your changes in your working directory
git reset --mixed amiaopensource:gh-pages

# Use the patch commit to add each recipe/change in a separate commit
git add . --patch   # NB: this can be abbreviated to git add . -p
gcmsg "Add glossary of technical terms"
# and so on...

@kieranjol
Copy link
Collaborator

kieranjol commented Dec 22, 2025 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants