Re: [PATCH] Add a document on how to contribute to the documentation

[Jani Nikula <jani.nikula@linux.intel.com>]

On Wed, 22 Jan 2020, Jonathan Corbet <corbet@lwn.net> wrote:
> This is mostly a collection of thoughts for how people who want to help out
> can make the docs better.  Hopefully the world will respond with a flurry
> of useful patches.

Thanks for writing this!

FWIW,

Acked-by: Jani Nikula <jani.nikula@intel.com>


> +The documentation TODO list
> +---------------------------
> +
> +There is an endless list of tasks that need to be carried out to get our
> +documentation to where it should be.

This reminds me of an old LCA talk of yours where you said,

"If we do this, we end up with, some years from now, this beautiful,
integrated documentation tree, that covers things in a comprehensive
way, where you can find what you want, looks pretty when you look at
it. It's a nice vision, I hear angels singing when I think about it and
so on, it's where I want to go."

Perhaps it would be time to include some concrete overall goals, a
mission statement if you will, somewhere near the top? I mean other than
"top-quality, comprehensive, better". Or "angels singing". ;)

Of course, can absolutely be a follow-up patch on top.

BR,
Jani.


-- 
Jani Nikula, Intel Open Source Graphics Center