Re: [gentoo-soc] Weekly report 07/30

[Brian Dolbec <dolsen@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1654 bytes --]

On Sun, 29 Jul 2018 08:20:01 -0700
Brian Dolbec <dolsen@gentoo.org> wrote:

> On Sun, 29 Jul 2018 21:40:30 +0800
> Pengcheng Xu <i@jsteward.moe> wrote:
> 
> > Hi all,
> > 
> > Last week's report is available now.  Link:
> > 
> > https://jsteward.moe/weekly-report-0730.html
> > 
> > Thanks!
> >   
> 
> While I am not directly involved with gsoc this year... I can't help
> but to respond here.
> 
> Reports like this were not acceptable in past years.
> 
> Just showing a link to a report is not enough.
> 
> A PROPER report here should include enough info to give the reader an
> idea if they want to follow the link and get all the details.
> 
> While I don't expect a 3 page essay, you should summarize what was
> done in brief, but clear writing.  The link to the full detailed
> report at the end.

I should have followed the link before responding...

The link contents is no more than a brief summary.  I didn't do a word
count, but, I think my previous reply was about the same size...  So
how hard would it have been to copy/paste that text into an email...

But I still find that report lacking for a detailed report.  You should
have included some details of what was done for the automatic setup.

Also, why are your user guides just in a blog? Shouldn't the user guides
be added to the Gentoo wiki?  Blog guide info I would think would only
be for brief preliminary help info for mentors and other actively
interested persons.  So as the project progressed, they could keep up
to date with the code.  But the real documentation should in my
opinion be put somewhere central like our Gentoo wiki.

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 981 bytes --]