From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alexis Newsgroups: gmane.emacs.devel Subject: Re: Next release from master Date: Wed, 10 Feb 2016 15:04:08 +1100 Message-ID: <871t8lcitj.fsf@gmail.com> References: <8qegda3kfg.fsf@fencepost.gnu.org> <83h9i695n5.fsf@gnu.org> <87si118q6e.fsf@gnus.org> <877fid5u3e.fsf@gmx.us> <87bn7pwgaj.fsf@wanadoo.es> <87y4atqq25.fsf@gnus.org> <877fidwaka.fsf@wanadoo.es> <8737t1ckh9.fsf@gmail.com> <56BAAF79.2010109@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; format=flowed X-Trace: ger.gmane.org 1455077074 26987 80.91.229.3 (10 Feb 2016 04:04:34 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 10 Feb 2016 04:04:34 +0000 (UTC) Cc: =?utf-8?Q?=C3=93scar?= Fuentes , jwiegley@gmail.com, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Feb 10 05:04:24 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aTM0u-00076x-3y for ged-emacs-devel@m.gmane.org; Wed, 10 Feb 2016 05:04:24 +0100 Original-Received: from localhost ([::1]:35291 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTM0q-00088y-9h for ged-emacs-devel@m.gmane.org; Tue, 09 Feb 2016 23:04:20 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47559) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTM0m-00088s-ER for emacs-devel@gnu.org; Tue, 09 Feb 2016 23:04:17 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aTM0j-0003WA-61 for emacs-devel@gnu.org; Tue, 09 Feb 2016 23:04:16 -0500 Original-Received: from mail-pf0-x22e.google.com ([2607:f8b0:400e:c00::22e]:35749) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTM0i-0003W6-Up for emacs-devel@gnu.org; Tue, 09 Feb 2016 23:04:13 -0500 Original-Received: by mail-pf0-x22e.google.com with SMTP id c10so5116532pfc.2 for ; Tue, 09 Feb 2016 20:04:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=references:user-agent:from:to:cc:subject:in-reply-to:date :message-id:mime-version:content-type; bh=jAerAfrHpF+d/EQ3hvDKm4Ju39zc+3TsogsY1QTKwm4=; b=QVIfiy8kYYP5movpLAal0taPTliRX3+vdjHPFpp534MNZsDcjPWJ4ZiuBKo4BQKkWL JLAbREkIHnF1NXzsNn9cHN5NJ9EIVQjrSFRDMtfETXIFYWAMzxt8A9icyIgtNTTyr9Ti 0mkNT42tTzIWTksRj71gNeYEAQD2UFz3iZbqGiI2h3kMOxNj/V6cddIWA0FUntTQI7As /m+nFe/MH/kvuCKhEbspLI3TMHH4yv+N+Njvbei0WBd+bpwv6Qt+nbo37fl14+Tgof2K JNfyZkYO3d4941nySlbYsk98uc0yzxdSG5AbD46cCxHTs7eN+HHz6VmsqDJusElalZDn cahQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:references:user-agent:from:to:cc:subject :in-reply-to:date:message-id:mime-version:content-type; bh=jAerAfrHpF+d/EQ3hvDKm4Ju39zc+3TsogsY1QTKwm4=; b=dvfTy275v7KuQ6M5T+jtHmN6QzNGAFABkF15IRkekms1w/LVz2kD8Ow/KS4CmMhAcP 0hqKC7WmVL421gDrfDVJ4Rx82cfcH7lRx0T1OQwIeCRhXhAwuTfVSY1lcJRXc/OdjP2b ukmUMAHbNfVyq+84xgHQv3buxAl+pTFFyeca7EhrUuGn7W7m8A4wd4g8sUYQ7rBikRps P+SRdapdA7+qUjFZpLC+3wfkIZU69mMkIxwfqAn55dsK1bzi+xPXk33Rre2AlkjMFP9f RG7U3g0Tt4nGkV20nJf9ffVfbmoPJReaV1Yl8O7KJ7iMrGHOdXzPEQ9i/AcJxDwvJRZ0 LcnQ== X-Gm-Message-State: AG10YOTVG5MGROEuOjdBBuo/ixCMNcTadBQyD78II2KhsLPvsv824TSByM5A2+G+kA8wvw== X-Received: by 10.98.19.22 with SMTP id b22mr52624232pfj.17.1455077052123; Tue, 09 Feb 2016 20:04:12 -0800 (PST) Original-Received: from localhost (114-198-67-137.dyn.iinet.net.au. [114.198.67.137]) by smtp.gmail.com with ESMTPSA id z67sm1089125pfa.71.2016.02.09.20.04.10 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 09 Feb 2016 20:04:11 -0800 (PST) User-agent: mu4e 0.9.16; emacs 24.5.3 In-reply-to: <56BAAF79.2010109@yandex.ru> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c00::22e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:199673 Archived-At: Dmitry Gutov writes: > I'm sure Eli (and the rest of us) would be very happy to see you > help with documentation. i'm sorry Dmitry, but i don't agree with the notion that people who don't understand the code they're documenting should be the first ones to document it. :-P (Though of course, they can certainly help clarify things they feel aren't clear in /existing documentation.) i don't expect others to document the code of the packages i've written, because: (a) others won't necessarily know what i /intended/ by the code, they can only work from what the code /seems/ to do. That makes it more difficult for non-me documenters to guess whether something is a bug or "working as intended". (b) i don't assume that my time is much more valuable than other people's. i don't think it's a net gain for the Emacs community to have somebody else spending, say, an hour or two coming to grips with code for the purposes of documenting what they /think/ is going on, rather than me spending 5-10 minutes just writing the documentation in the first place. (c) at a basic level, my point was not "i have a problem with Eli being the main person writing documentation" so much as "i have a problem with the fact that it's /necessary/ for Eli, /or anyone else/, to be having to write documentation for code they haven't written, because the developers of the code in question have treated documentation as Somebody Else's Problem". If you think that it's not important to provide documentation for the code you write, then okay, but that's not a position i share. Having said all that, i'd be interested to hear John's thoughts on this matter (who i've cc'd), and will follow his lead on this. Alexis.