[PATCH 1/4] doc: add high level introduction to documentation main page

[Jani Nikula]

On Mon, 29 Jan 2018, Sean Paul <seanpaul at chromium.org> wrote:
> On Mon, Jan 29, 2018 at 02:28:52PM +0200, Jani Nikula wrote:
>> It's a bit harsh to welcome the reader with just contents.
>> 
>> Signed-off-by: Jani Nikula <jani.nikula at intel.com>
>> ---
>>  index.rst | 16 ++++++++++++++++
>>  1 file changed, 16 insertions(+)
>> 
>> diff --git a/index.rst b/index.rst
>> index f5f8e95571eb..6110cc796d2a 100644
>> --- a/index.rst
>> +++ b/index.rst
>> @@ -1,6 +1,22 @@
>>  DRM Maintainer Tools
>>  ====================
>>  
>> +This documentation covers the tools and workflows for maintaining and
>> +contributing to the Linux kernel DRM subsystem drm-misc and drm-intel
>
> drm-amd says "Hi"! Perhaps a pointer to nightly.conf would be more future-proof.
> Same nit below.

I know we've prepared for and welcomed drm-amd by including their trees
in drm-tip; I'm not aware that they're actually using dim to manage
their trees. Harry, what's the status?

Either way, I should amend the parts about repos and drm-amd being
included in drm-tip. My bad, I was just converting the old stuff without
much thinking.

> With that resolved
> Reviewed-by: Sean Paul <seanpaul at chromium.org>

Thanks, sorry for being a bit trigger-happy with git push there.

BR,
Jani.


>
>> +repositories. The intended audience is primarily the maintainers and committers
>> +of said repositories, but the workflow documentation may be useful for anyone
>> +interested in the kernel graphics subsystem development.
>> +
>> +Both drm-misc and drm-intel are maintained using the same tools and very similar
>> +workflows. Both feed to the same testing and integration tree, the drm-tip. The
>> +documentation here is mostly shared, highlighting the differences in workflows
>> +where applicable.
>> +
>> +Please use the `dim-tools at lists.freedesktop.org`_ mailing list for
>> +contributions, bug reports, and discussion about the tooling and documentation.
>> +
>> +.. _dim-tools at lists.freedesktop.org: https://lists.freedesktop.org/mailman/listinfo/dim-tools
>> +
>>  Contents:
>>  
>>  .. toctree::
>> -- 
>> 2.11.0
>> 
>> _______________________________________________
>> dim-tools mailing list
>> dim-tools at lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/dim-tools

-- 
Jani Nikula, Intel Open Source Technology Center