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

[Harry Wentland]

On 2018-01-29 03:24 PM, Deucher, Alexander wrote:
>> -----Original Message-----
>> From: dim-tools [mailto:dim-tools-bounces at lists.freedesktop.org] On Behalf
>> Of Jani Nikula
>> Sent: Monday, January 29, 2018 3:16 PM
>> To: Sean Paul <seanpaul at chromium.org>
>> Cc: Wentland, Harry <Harry.Wentland at amd.com>; dim-
>> tools at lists.freedesktop.org
>> Subject: Re: [PATCH 1/4] doc: add high level introduction to documentation
>> main page
>>
>> 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?
> 
> We don't use drm-amd at the moment.  The thinking is that we will at some point, but we aren't there yet.
> 

I've setup dim tools last week. I can see myself using it, but I think ultimately this is probably a change that doesn't just affect Alex and myself but everyone at AMD that contributes to amdgpu/radeon.

I also have a bit of a backlog of dim-tools emails to go through, so I'm not fully up-to-date on DIM yet.

Alex, we should probably have a chat about this sometime in the near future.

Harry

> Alex
> 
>>
>> 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
>> _______________________________________________
>> dim-tools mailing list
>> dim-tools at lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/dim-tools