Re: [docs] [PATCH 00/10] docs: highlight BitBake snippets with the bitbake language

["Antonin Godard" <antonin.godard@bootlin.com>]

Hi Quentin, Trevor,

After having thought about this a bit more, I think there are pros and cons to
both approaches, but I'm leaning towards Quentin's approach. The other approach
may feel "safe", and doesn't leave room to errors, but I'm afraid that 1. most
contributors will forget about it and 2. it might make the process more painful
for them.

So here what we should do:

- set `hightlight_language = "bitbake"` in conf.py.

- remove file-wide lexer enforcing (.. highlight:: directive at the top of the
  file) (in a separate patch)

- use the appropriate lexer for each code-block that is _not_ bitbake code.

- fix any parsing error from the bitbake lexer (I did have some when trying it).
  If this happens, use "none" and *add a identifiable comment* above it to
  explain that there's an issue with the lexer. This way we can track them and
  fix them when Pygments gets an update.

- document this way of proceeding in standards.md.

If you think of anything else we should do here, please share your thoughts :)

Trevor, if you want to send another version of your series, please rebase on
*master-next* as it contains cleanups to the conf.py file at the moment (+ some
possible additional code-blocks).

Thanks both for sharing your thoughts on this!

Antonin