Be clearer about how the bitrate fields in Flows should be set

Aperta
  • Qualcosa non va?
#236 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Ambito
documentation

Direzione di ricerca

Inizia da docs/appnotes/0013-setting-flow-bit-rate-properties.md e dalla revisione collegata di Flow Profiles. Esplora la distinzione tra avg_bit_rate e max_bit_rate in un ADR, quindi aggiorna i campi pertinenti dell’appnote o della specifica. Il lavoro è completato quando l’ADR e la documentazione spiegano chiaramente le aspettative di qualità e la dimensione minima del buffer del client.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation spec

Context
The Flow Profiles PR review pulled up some questions about whether max_bit_rate or avg_bit_rate make sense to appear in Profiles. The conclusion was to suggest that avg_bit_rate should, and should be seen as the target you might set an encoder to, whereas max_bit_rate behaves more like a measured value.

https://github.com/bbc/tams/blob/main/docs/appnotes/0013-setting-flow-bit-rate-properties.md suggests some approaches by which bit rate might be set, and how it might be used to calculate minimum buffer size etc.

It would be better if we were clearer about how these might be used, and the split between each. In general the bitrate of a piece of content is used for two purposes. While (2) can be used for (1) (and to a degree, vice versa) it is sometimes useful to indicate that quality even without any content, and be able to construct a Profile describing the approximate quality, so merging them may not be ideal.

  1. Understanding broadly what quality to expect, when read alongside the codec and essence parameters
  2. Understanding the minimum acceptable buffer size on a client to avoid a playback stall

Also tracked as https://jira.dev.bbc.co.uk/browse/CLOUDFIT-5601

Actions

  • Write an ADR exploring options around how the two fields be used, e.g. using avg_bit_rate as more of a target than a measure
  • Amend the appnote/fields in the spec to indicate that distinction

Outcome

  • ADR on bitrates
  • Spec/Appnote tweak
Lingua principale
Makefile
Stelle
117
Fork
13
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di bbc/tams

Tutte le issue di bbc/tams

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.