Re: [Ksummit-discuss] [TECH TOPIC] Documentation

Mike Rapoport <[email protected]> Fri, 12 Jun 2020 12:07:06 +0300
Newsgroups org.linuxfoundation.lists.ksummit-discuss,dev.linux.lists.ksummit
Message-ID <[email protected]>
On Thu, Jun 11, 2020 at 11:28:09AM -0700, Joe Perches wrote:
> On Thu, 2020-06-11 at 12:03 -0600, Shuah Khan wrote:
> > People that know the sub-systems well might not
> > have time to document and more importantly keeping the documents
> > updated.
> 
> So you somehow expect people that do _not_ know the
> sub-system well to produce good and useful documentation?

Writing documentation is a way to learn.

Besides, to produce good and usefull documentation it is not necessary
to have very deep understanding of all the small details. The writer
must capture the large picture and be able to explain it.
 
> _______________________________________________
> Ksummit-discuss mailing list
> [email protected]
> https://lists.linuxfoundation.org/mailman/listinfo/ksummit-discuss

-- 
Sincerely yours,
Mike.
_______________________________________________
Ksummit-discuss mailing list
[email protected]
https://lists.linuxfoundation.org/mailman/listinfo/ksummit-discuss