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 2B5C81382C5 for ; Wed, 1 Jul 2020 02:37:26 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 0AAD9E089C; Wed, 1 Jul 2020 02:37:25 +0000 (UTC) Received: from raba.swcp.com (raba.swcp.com [216.184.2.46]) (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 AB378E089C for ; Wed, 1 Jul 2020 02:37:24 +0000 (UTC) Received: from roundcube.swcp.com (roundcube.swcp.com [216.184.2.221]) by raba.swcp.com (8.15.2/8.15.2/Debian-14~deb10u1) with ESMTP id 0612bMbc029827 for ; Tue, 30 Jun 2020 20:37:23 -0600 Received: from roundcube.swcp.com (localhost [127.0.0.1]) by roundcube.swcp.com (8.15.2/8.15.2/Debian-8) with ESMTP id 0612bMEZ027528 for ; Tue, 30 Jun 2020 20:37:22 -0600 Received: (from www-data@localhost) by roundcube.swcp.com (8.15.2/8.15.2/Submit) id 0612bLh1027525; Tue, 30 Jun 2020 20:37:21 -0600 X-Authentication-Warning: roundcube.swcp.com: www-data set sender to ebo@sandien.com using -f To: Subject: Re: [gentoo-soc] Weekly Report: Portage Powered Android X-PHP-Originating-Script: 1000:main.inc 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 X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Date: Tue, 30 Jun 2020 20:37:21 -0600 From: EBo In-Reply-To: <20200630214243.whbalwggeped7ofq@tardis.localdomain> References: <20200629201204.hssao7lsdtcmpsme@tardis.localdomain> <20200630214243.whbalwggeped7ofq@tardis.localdomain> Message-ID: <992acbebda6cb5f585e1797c9712102f@mail.swcp.com> X-Sender: ebo@sandien.com User-Agent: Roundcube Webmail/0.8.2 X-Archives-Salt: 0c1dcbe3-1dfb-406f-9776-4b6b1aa20796 X-Archives-Hash: 63591a8f7ea1d8bac261b26243f8b54a On Jun 30 2020 3:42 PM, Gunwant Jain wrote: > On 20/06/29 03:27PM, EBo wrote: >> Getting everything set up to move forward is sometimes the hardest >> thing... >> You will have to discuss this with your mentor, but a few posts in >> some >> appropriate indexed forum would be very useful for others. Also, if >> you can >> document what steps you went through to make it work. Speaking for >> myself, >> once I get something like this to work I start off with a clean >> dir/disk and >> follow my notes step by step so that I know I did not miss anything >> when >> writing it all down. > > I am not quite sure what you mean by using a forum for posts, if it > is > regarding having a public announcement of sorts, I plan to do it when > we > finish implemententing the basic idea of SharkBait. > I agree that documenting will play a crucial role in my journey. And > for > that I had set up a personal blog earlier [1]. I am actively writing > new > blogs, thoroughly explaining whatever I do from scratch. There are many places that people post questions/answers. I know of one group that almost exclusively use StackOverflow. Others various gentoo forums (see: https://forums.gentoo.org/). It is really up to you and your preferences. That said it needs to be indexed and searchable. Can you guarantee that your personal blog be around for the next decade (a reasonable life expectancy for such a project)? I am simply suggesting posting overviews/FAQ's in venues that we can expect to have around for many years and be searchable by google, etc. > I am also open to any suggestions to a better medium you might have > for > the documentation. I have to be very careful here. Even moderately decent documentation is a LOT of work, and I know of people literally writing documents full time for very good pay. I could make some suggestions, and it could take so much time and derail other efforts that would be your mentor's priority. I do not want to cause any issues by interjecting comments from time to time. Also, it will be months or more before I will have enough breakout time to give this a real shot for install/use.