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

[Deucher, Alexander]

> -----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.

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