Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:99280 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 71821 invoked from network); 30 May 2017 19:27:00 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 30 May 2017 19:27:00 -0000 Authentication-Results: pb1.pair.com smtp.mail=smalyshev@gmail.com; spf=pass; sender-id=pass Authentication-Results: pb1.pair.com header.from=smalyshev@gmail.com; sender-id=pass Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.218.48 as permitted sender) X-PHP-List-Original-Sender: smalyshev@gmail.com X-Host-Fingerprint: 209.85.218.48 mail-oi0-f48.google.com Received: from [209.85.218.48] ([209.85.218.48:33305] helo=mail-oi0-f48.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 5C/C4-43873-487CD295 for ; Tue, 30 May 2017 15:27:00 -0400 Received: by mail-oi0-f48.google.com with SMTP id w10so124505912oif.0 for ; Tue, 30 May 2017 12:27:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-transfer-encoding; bh=5n3j/AaP66NaG+G+nUhar8J4YcUNv6raAecqQoVD1Qw=; b=cyxUp1Wgj8Gw+UOwKcxhOxfV2/f92UDOqr49Th1RIIKUf4qQqgn5U8FjHOmM9SQh+O i525Z/vfn/nA/YJpSAX3kgNTRkzTvWM76UTdskvJsYKvXZP1J6Vl+d9plD/+AL7ewpmP E50R0Jd4QiCZX/kQIohBmF5qPPePnEax2BbPaFK812e6cVyFka/aWiTpLHCuL953yAaH ltsckFKMoax1Uu+d7oW94loibGv8d1/mztWE8zCEgqCtU93sZmxK4d8L4NbrYEyLfiAn aTfizq6AalWSLj+HEsyUJGgmbCjO+on/zOtj/rvTT33mE9X0lLHcWTYzIScGZY8Pf7p1 mOrA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding; bh=5n3j/AaP66NaG+G+nUhar8J4YcUNv6raAecqQoVD1Qw=; b=HmktxiphSRlFHbOhw4uMF4hyWZorlWxHJUSGCpydaEzusdc+vfYPtVTNc/Sf5sQ+FL uptfFHhwSfgA4DfQ5xit1fNC+avAKu+I1GtZeKCStal0Oit+RdhkUL1GijSZuwxkBBdp mJeEJw9FNFZugvOt2HcWsm71RFzC5k3ktu/IJmH1jQL8GIVRmc+08q8Papw+Tpu/oh4J 6vcec3qb5bJz8y3cg59f7IDHcn/hOamv6OqKabFv0feKeIrW+rz+9nCj4KXb3G7Iw7hi 149iV32KyJauVJvf7L0jlDLkufdtzzqz74Gn1WBxuO+P1zIQz4zKROIP562BBQ7GEZvc THIw== X-Gm-Message-State: AODbwcAKZ/lw/LSSvpxhQP/AR/89dwN+nMIR+x1FFvYAVWA0a+Y/WYZx CcUPGGzqaDuxn+uVZ14= X-Received: by 10.157.39.14 with SMTP id r14mr2538024ota.11.1496172417188; Tue, 30 May 2017 12:26:57 -0700 (PDT) Received: from Stas-Air-5508.local (108-233-206-104.lightspeed.sntcca.sbcglobal.net. [108.233.206.104]) by smtp.gmail.com with ESMTPSA id 14sm6429357oib.11.2017.05.30.12.26.56 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 30 May 2017 12:26:56 -0700 (PDT) To: Fleshgrinder , php-internals References: <5fca5c60-828d-5fb4-8ef8-74d69036e8f8@gmail.com> <5d5fe894-7ef7-23c5-cba1-4cb7a305207f@fleshgrinder.com> Message-ID: Date: Tue, 30 May 2017 12:26:59 -0700 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 In-Reply-To: <5d5fe894-7ef7-23c5-cba1-4cb7a305207f@fleshgrinder.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Subject: Re: [PHP-DEV] Documentation (Doxygen) From: smalyshev@gmail.com (Stanislav Malyshev) Hi! >> But randomly introducing docs system without any explicit decision in an >> unrelated patch doesn't look like a good idea to me. >> > > Wow! This sounds like you think that I am trying to deliberately > sabotaging the PHP project. Quite the opposite is the case. I am simply Sorry if it sounded that way, I of course meant nothing like it. I just meant that introducing docs standard should not be made in a routine unrelated patch, where it could be missed by many people, but as an ordered process. Otherwise, you'd introduce Doxygen, somebody unaware of it would introduce another thing, and pretty soon we have code documented in a dozen of incompatible ways and it's a mess. I certainly did not imply any malice on your part, just that we need to do it in an explicit way that informs everybody what it happening. > used to properly documenting my code, as it is part of any professional > code base in my opinion. Surely, and it's without doubt a good thing. We just need to do it right, otherwise we'd have to spend more time later to fix it. It requires a bit of time, but better spend it now than end up with code documented in a way that no doc system would be able to parse, IMO. -- Stas Malyshev smalyshev@gmail.com