Wu XiangCheng <wu.xiangcheng@xxxxxxxxx> writes:
> From: Wu XiangCheng <bobwxc@xxxxxxxx>
>
> * update to commit 163ba35ff371 ("doc: use KCFLAGS instead of
> EXTRA_CFLAGS to pass flags from command line")
>
> Signed-off-by: Wu XiangCheng <bobwxc@xxxxxxxx>
> ---
>
> One question here:
> Should we use `#)` to replace ordered list prefix `Number)` ?
> It's inconvenient to manually modify them every time. Auto
> generating is better.
There is clear appeal to autogeneration, but it reduces the readability
of the plain-text form slightly.
A better question, perhaps, is: do we actually need the bullet points to
be enumerated at all? Nothing refers to those numbers, and there is no
particular ordering there. So a better solution in this case might be
to just get rid of the numbers entirely.
Of course, this documentation file needs a bit more attention than
that...
Anyway, I've applied the patch.
Thanks,
jon
