[FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

[Andrew Sayers]

On Sun, May 05, 2024 at 10:31:18AM +0200, Andreas Rheinhardt wrote:
> Andrew Sayers:
> > Derived from detailed explanations kindly provided by Stefano Sabatini:
> > https://ffmpeg.org/pipermail/ffmpeg-devel/2024-April/325903.html
> > ---
> >  doc/context.md | 308 +++++++++++++++++++++++++++++++++++++++++++++++++
> >  1 file changed, 308 insertions(+)
> >  create mode 100644 doc/context.md
> > 
> 
> Who is the intended audience of this file? (Aspiring) internal
> developers or external API users?

External API users.  This needs to say e.g. "ignore anything called
`internal` or `priv_data`", whereas a document for new internal devs
would say which one to prefer in new code.  That would be very
useful, but well beyond my current abilities.

(I'm still travelling so have low mental and typing bandwidth, but am
thinking through other responses and should have time to respond in
the coming days)