From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 59993138334 for ; Sun, 29 Jul 2018 18:30:34 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 1D595E0809; Sun, 29 Jul 2018 18:30:33 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id BCD70E0809 for ; Sun, 29 Jul 2018 18:30:32 +0000 (UTC) Received: from localhost (unknown [91.246.100.127]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: bircoph) by smtp.gentoo.org (Postfix) with ESMTPSA id 27B6F335C71 for ; Sun, 29 Jul 2018 18:30:29 +0000 (UTC) Date: Sun, 29 Jul 2018 21:30:25 +0300 From: Andrew Savchenko To: gentoo-soc@lists.gentoo.org Subject: Re: [gentoo-soc] Weekly report 07/30 Message-Id: <20180729213025.d8b7560a406b8d20929f7ecc@gentoo.org> In-Reply-To: <20180729083614.242a40c9@professor-x> References: <20180729082001.3a3f3c4e@professor-x> <20180729083614.242a40c9@professor-x> X-Mailer: Sylpheed 3.7.0 (GTK+ 2.24.30; i686-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-soc@lists.gentoo.org Reply-to: gentoo-soc@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; protocol="application/pgp-signature"; micalg="PGP-SHA512"; boundary="Signature=_Sun__29_Jul_2018_21_30_25_+0300_8ViGk2GguQfvqA3N" X-Archives-Salt: 00601c9f-9959-4f6e-bd0a-83bca2b94415 X-Archives-Hash: bd01157c2b217b7564af3f3994f5a45b --Signature=_Sun__29_Jul_2018_21_30_25_+0300_8ViGk2GguQfvqA3N Content-Type: text/plain; charset=US-ASCII Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi! On Sun, 29 Jul 2018 08:36:14 -0700 Brian Dolbec wrote: > > While I am not directly involved with gsoc this year... I can't help > > but to respond here. > >=20 > > Reports like this were not acceptable in past years. > >=20 > > Just showing a link to a report is not enough. > >=20 > > 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. > >=20 > > 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. >=20 > I should have followed the link before responding... >=20 > 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... >=20 > 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. >=20 > 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. Brian, looks like you missed our workflow. Weekly e-mail reports are just pointers to the work done this week and documented in the blog. The blog entry itself is exactly what you described as "you should summarize what was done in brief, but clear writing. The link to the full detailed report at the end." It contains clear summary with each paragraph linked to the detailed technical or workflow description. Just follow the links on the blog page: https://jsteward.moe/category/gsoc-2018.html (the first link is broken now by some typo and will be fixed). As for documenting in the wiki, please see previous week's report: https://jsteward.moe/weekly-report-0723.html So moving essential parts of the blog posts to the wiki is on the plan. But frankly having the job done and documentation written is more important than bikeshedding about where the docs must be located. IMHO Wiki is not the best place for them, for one of the reasons ask williamh why. Best regards, Andrew Savchenko --Signature=_Sun__29_Jul_2018_21_30_25_+0300_8ViGk2GguQfvqA3N Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEE63ZIHsdeM+1XgNer9lNaM7oe5I0FAlteB8IACgkQ9lNaM7oe 5I3n5A/9HBbcrhOxBi1/03linMKVn3u9DJDSd189ZcKbWhj0ZmpNw+cVGpusDniB P7jFU26Q/d+rg7zB4uA1hiOXn4G9N42KiK+xIfBpYf7PBVJPy5I12QJxBAmGj1fC MVYhWxWpEqTvL6u5/8KXpP61fX4YtBxSVHVcYXMNWYo9qm4mPFczIcrjGk7zDTFW atETkkZLJ4vMAan4FNOY4b7m9PRS2qbL3nR5XbM4Gw/Yj2/t9HreuMKE/wc5+3Vr uYoQFCZsH041wMm4UoAjk+1qA+xByOqtND3hFnijvHVMTF6XgIYq6JG43GaXvPLq mhg/YuqQHUXMoFMsqrfzFOQa6mwWo4vIEGRWnzzvxUzQCh2ol3I/6zvMnykHlmN0 8Erheu5ZpHyK3MVhITrmZet+L/GYRKjk2Va69PueLU75zllI7it4H/UISLJnE1B0 1purQohm9TeFRF8SM1S03fa7lVQS3dC8KsHRsMquuyOJgXy/mxzBTcIDkguoH1Qq /xGfhg/ikqJR/OExrBPHPcl7dxfdEiiCAk5W8KEFMBWXad6RpXet9iXtNPJoMRUx HPxlvNScPz6wTiHUFG6kr5c7qLOv3MPaqbgjwQPgVf4cU1BG69NxTsGmq/0TL6f6 MmStqD3ICOAgz++Kv9B5y4Y0CSg4ETwDXNcDCNoW1r4vE7GzuxI= =olLR -----END PGP SIGNATURE----- --Signature=_Sun__29_Jul_2018_21_30_25_+0300_8ViGk2GguQfvqA3N--