From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6451845424769662976 X-Received: by 10.223.181.146 with SMTP id c18mr375275wre.18.1502201491687; Tue, 08 Aug 2017 07:11:31 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 10.28.31.199 with SMTP id f190ls1857160wmf.25.canary-gmail; Tue, 08 Aug 2017 07:11:31 -0700 (PDT) X-Received: by 10.223.150.248 with SMTP id u111mr409980wrb.1.1502201491465; Tue, 08 Aug 2017 07:11:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1502201491; cv=none; d=google.com; s=arc-20160816; b=cKo0zti4Q8OBHTrVW+1/7Yf+tbKoIbZt1+XRHEtY+XTinWSPQ/BNq2NsaBklxfrOsM yei8dETThZmr/OcDBO8KlDruRHi1vbWttW/qtOvk9nmY/pFetz/3NPX4/6+y0ivT3sYB oE1w7PLw6AvzmQA87sR19Tslkcp36TjAKDQquL3O2f1w5ceIxcaI9RE52kqEZEzKZdMO jAheugktpsJP7wIkApdOh8xKqlX+bcyfLQVvbM78fLU5YGCd11UCkRLapQ7vwE7kyDeh U3vmYzsd6BZilWPgBvULNxza96UAoZXqblOBwf82CMfPmfWqOT620+PVKmFtIv6uWMF1 8Plg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date :arc-authentication-results; bh=+C+ngrwQF8PZPSjQ5BjvqPtv3PCLAu6FZjPSYeKfhSs=; b=myPdgj3ZENMQ8sEHVRBk2jsqmE4k8beWA/md/eqPdZgnnoq31tKsDsx3EdUcy0WD0a HlBEMwWnFzM4hHoexl5nEAP41pfWDx9eys0zzJ3wc6MVJHBa45MX4zBUW0qc9fcPiynh EvPK+x8GkJvSm5J6TN2BNAFMRQVEo3mq1ruFTL1pPun5ijk+tvvqROPSYWwSvmb+kXbc vXrYEYZhH2HiNI192PZpRiN90krM3u30sGoN7XIpoHv/OHM17UP+xg7dkQDjKw8yKMZ3 4ACAgaYHuBHJac2IinOgmWLWeZdiIQ9pzGFWBmcws9Hiyhs2yclKb18d5ehkRiP4wirY 0bIw== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 85.214.62.211 is neither permitted nor denied by best guess record for domain of ibr@radix50.net) smtp.mailfrom=ibr@radix50.net Return-Path: Received: from aqmola.ilbers.de (aqmola.ilbers.de. [85.214.62.211]) by gmr-mx.google.com with ESMTPS id z192si523758wmz.5.2017.08.08.07.11.31 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 08 Aug 2017 07:11:31 -0700 (PDT) Received-SPF: neutral (google.com: 85.214.62.211 is neither permitted nor denied by best guess record for domain of ibr@radix50.net) client-ip=85.214.62.211; Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 85.214.62.211 is neither permitted nor denied by best guess record for domain of ibr@radix50.net) smtp.mailfrom=ibr@radix50.net Received: from yssyq.radix50.net ([206.167.44.205]) (authenticated bits=0) by aqmola.ilbers.de (8.14.4/8.14.4/Debian-4+deb7u1) with ESMTP id v78EBRS3023433 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 8 Aug 2017 16:11:30 +0200 Received: from yssyq.radix50.net (localhost [127.0.0.1]) by yssyq.radix50.net (8.14.4/8.14.4/Debian-8) with ESMTP id v78BkWSA009491 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 8 Aug 2017 13:46:32 +0200 Received: (from ibr@localhost) by yssyq.radix50.net (8.14.4/8.14.4/Submit) id v78BkWx1009490 for isar-users@googlegroups.com; Tue, 8 Aug 2017 13:46:32 +0200 Date: Tue, 8 Aug 2017 13:46:32 +0200 From: Baurzhan Ismagulov To: isar-users@googlegroups.com Subject: Re: [PATCH] doc: Add technical overview Message-ID: <20170808114632.GB5314@yssyq.radix50.net> Mail-Followup-To: isar-users@googlegroups.com References: <20170808100559.19682-1-asmirnov@ilbers.de> <20170808131102.0ef91da0@md1em3qc> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20170808131102.0ef91da0@md1em3qc> User-Agent: Mutt/1.5.23 (2014-03-12) X-TUID: sA2YioI0NK0Z On Tue, Aug 08, 2017 at 01:11:02PM +0200, Henning Schild wrote: > I did not really read this yet. At the moment i think we have too many > changes in the q to add such a document to the repository. Any change > would just mean heaving to keep it up to date. > We talked about the need for such a document for the possible OE > integration. I think it is valuable for that already. > > That should be added after we all are happy with the feature-set of > Isar, until then it would just be another file to update when changing > how things work. This is exactly one of the goals of documenting this at this stage. It is important to document architecture changes, in small steps along the way. Otherwise, later it will be difficult to understand the big picture and the motivation for the changes from the many patches. I think that changing a couple of paragraphs in the 110 lines of a really high-level overview shouldn't be that difficult to do and is well worth it. On a related note, my problem with some of the patches at this list is that I see what the code does, but don't see the context and motivation. So, if a patch requires a change in the document, providing it will only speed up the review process. With kind regards, Baurzhan.