docs: driver-api: firmware: add driver firmware guidelines. (v3)
authorDave Airlie <airlied@redhat.com>
Thu, 21 Jul 2022 04:43:52 +0000 (14:43 +1000)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Thu, 28 Jul 2022 08:57:18 +0000 (10:57 +0200)
commit321eaf317dec3710e7a4ad3b3c363d9314c15195
treeef1a8ec371c13e8bff7395b9785ff25513b55d35
parent3fcbf1c77d089fcf0331fd8f3cbbe6c436a3edbd
docs: driver-api: firmware: add driver firmware guidelines. (v3)

A recent snafu where Intel ignored upstream feedback on a firmware
change, led to a late rc6 fix being required. In order to avoid this
in the future we should document some expectations around
linux-firmware.

I was originally going to write this for drm, but it seems quite generic
advice.

v2: rewritten with suggestions from Thorsten Leemhuis
v3: rewritten with suggestions from Mauro

Acked-by: Luis Chamberlain <mcgrof@kernel.org>
Acked-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
Acked-by: Daniel Vetter <daniel@ffwll.ch>
Acked-by: Harry Wentland <harry.wentland@amd.com>
Signed-off-by: Dave Airlie <airlied@redhat.com>
Link: https://lore.kernel.org/r/20220721044352.3110507-1-airlied@gmail.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Documentation/driver-api/firmware/core.rst
Documentation/driver-api/firmware/firmware-usage-guidelines.rst [new file with mode: 0644]