Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:124360 X-Original-To: internals@lists.php.net Delivered-To: internals@lists.php.net Received: from php-smtp4.php.net (php-smtp4.php.net [45.112.84.5]) by qa.php.net (Postfix) with ESMTPS id 4E4D51ADBF7; Wed, 10 Jul 2024 17:53:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=php.net; s=mail; t=1720634094; bh=2CM1aKv5nBkQgyYkaJaAeeRvg8nLqxEUyZSYUZ4YZtk=; h=References:In-Reply-To:From:Date:Subject:To:Cc:From; b=QuF7IFP3pjEOZZ6tkmO6nJWqdqsTmshntorXnr/Ipj81wueHZKagZv8Rqyybo32rv NWWvBT09K9PG3LF/jN1tPgdhO3VtRKL7NCXBiEMmU7/VgmpM83GmRMYrSWo4zIg6DW WixPIqw47T4ureSCWAfaElJsaKXTVJ8u/SrvckL/ihZi/gcYSi1xmYZNVvKaSMT2Aq HKI58oYuhd476aI7lTVQudfjB5UtSNGOL/lMs9eeg0gVbl5Bi+kKyW6VqqMBlB0Obh TCum6go340ONYoZRRMUEsYJoAtFJ4K7sFhIJkHUrrtfuJRQ6Q9FhB5Y+TtKyUIMt9b hpKxqIl3DLjdQ== Received: from php-smtp4.php.net (localhost [127.0.0.1]) by php-smtp4.php.net (Postfix) with ESMTP id B5808180212; Wed, 10 Jul 2024 17:54:50 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on php-smtp4.php.net X-Spam-Level: X-Spam-Status: No, score=0.6 required=5.0 tests=BAYES_50,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,DMARC_PASS,FREEMAIL_FROM, HTML_MESSAGE,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE, SPF_PASS autolearn=no autolearn_force=no version=4.0.0 X-Spam-Virus: No X-Envelope-From: Received: from mail-yb1-f176.google.com (mail-yb1-f176.google.com [209.85.219.176]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by php-smtp4.php.net (Postfix) with ESMTPS; Wed, 10 Jul 2024 17:54:48 +0000 (UTC) Received: by mail-yb1-f176.google.com with SMTP id 3f1490d57ef6-dff17fd97b3so7305299276.2; Wed, 10 Jul 2024 10:53:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1720634002; x=1721238802; darn=lists.php.net; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=OUHv/jmj17k94OcgdOsXsvnjnAkT9S9VVEglz6AaEas=; b=aO+ixdtsprYwPOrhnU358IhvNMUc2smOl8DHe/8/UByX7v1LUgGW/FaFIZ5zJ9HfNM aft7y8ZvtNvwMIO/zg1LYiFlskKAwHDq0/Ctg4WGUMZ/CEsWkW3zhuUY1VY1Ed/G5XxW s5SoBk/FruWDC31h71HUWbF87syBYeRA2K3Joh742FiKtR4hPk4iSPICPORHidnzeR/5 dukNjhK2kewmDl8uoRdcAZNj0/vy/J81mahKLtjvZitsxn4OnFf9n/MdrZnkpK7RZ8eD CQszxAbtxV/U0uo6UuM5+f7jCbiFc3K3vTbWqPC8SYOs2ZrFqEBEMcY0DsfEtuxbcmaZ Krzg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720634002; x=1721238802; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=OUHv/jmj17k94OcgdOsXsvnjnAkT9S9VVEglz6AaEas=; b=msDo64cVNguWLXEkoW7ncJu/hAmHJYXVNNZeuQF+gV0VEeMJx1UC1DBf72IWIK4Rk2 9HUl5TjlI05MSWTTcprVI59fEbxZVnJXIETr3awnHZRQBFMSDe0XA2OP2NQAlPsU3VZn scZzRcGNgDy8Vht4RnU1sB4aCxQV1xBh5ZZ92dJm24BQw1vSkeJyu8PKKs8VxyehTV8c 6qjnsJWkOeBcS/Q377DLHDBuWOFE6xtBnZX7ZO2y938kFTvTeSzKyJ5olpYqMzf1if+x TBiAmekXGdhess03ZV6VAuGThl627pqFBUk0HtcD0QYP1bJvhnktpceaAKIrMEPk7JOV blbA== X-Forwarded-Encrypted: i=1; AJvYcCVGmbgEyuP1QO6gW6q4HMafpVQn8r7eiFHbd9tIAnnMXskDNkIhu4qop0aSBMmQy5j0cX/2KCUpxutTiOsFl1/k4rFpE0xGeA== X-Gm-Message-State: AOJu0YzlprHNs//1d3Bbk9cB3TOijAacpczkFPCpdoXQ5+aLOZGjChDR 5bwo7T28xiKdVk9KBUfTN9Wae6bdBjXm2NtAM4oEYPrz/VV9Jvq+b8o3+/iLUSPAFTkUybofd0l M0YgfUR3qIf4a8D+mexMzKdcrVb6ndhoCOgY= X-Google-Smtp-Source: AGHT+IF6mair1uKIrAo13gjwhC5COEbe2uMexjN/vouqm6PSYlMCiGO42jO6XCwqNEO7JbVmy+iwEoXvnWMRJZ6ZYeg= X-Received: by 2002:a17:90a:3001:b0:2c7:aba6:d32f with SMTP id 98e67ed59e1d1-2ca35c69399mr5373625a91.22.1720633663727; Wed, 10 Jul 2024 10:47:43 -0700 (PDT) Precedence: bulk list-help: list-post: List-Id: internals.lists.php.net MIME-Version: 1.0 References: In-Reply-To: Date: Wed, 10 Jul 2024 18:47:07 +0100 Message-ID: Subject: Re: [PHP-DEV] Negatively Voted Notes To: Derick Rethans Cc: PHP Documentation List , PHP Developers Mailing List Content-Type: multipart/alternative; boundary="00000000000050b506061ce83e35" From: fenniclog@gmail.com (fennic log) --00000000000050b506061ce83e35 Content-Type: text/plain; charset="UTF-8" On Wed, 10 Jul 2024 at 15:18, Derick Rethans wrote: > Hi! > > There are currently nearly 20000 notes in the documentation, with many > having a very high negative rating. > > For example, there are: > > 1131 notes older than a year, with a rating less than -10 > 2339 notes older than a year, with a rating less than -5 > 5761 notes older than a year, with a rating less than -1 > > The worst offender is: > > https://www.php.net/manual/en/features.cookies.php#128286 with -159 (not > sure why the website says -153) > https://www.php.net/manual/en/language.attributes.overview.php#126887 > with -104 > > We discussed this during one of our foundation meetings, and we propose: > > - to delete all notes with a rating less than -5 that are older than a > year. > - come up with a plan to crowd source going through the other thousands > of notes to see if they need to be deleted or integrated into the > actual text. Each documentation page now has a link to the XML source > (such as > https://github.com/php/doc-en/blob/master/language/attributes.xml) > > Comments? > > cheers, > Derick > > > -- > https://derickrethans.nl | https://xdebug.org | https://dram.io > > Author of Xdebug. Like it? Consider supporting me: > https://xdebug.org/support > > mastodon: @derickr@phpc.social @xdebug@phpc.social > This is something im both For and Against. On the *for* side, alot of these notes are negative rated for a reason, bad code, bad advice, incorrect usage, etc etc But on the *against* said is removing information, no matter how bad the code is or misunderstood, in my eyes no information should be removed. Let users see others' mistakes, so they dont repeat them. This is what the rating system is for. The only stuff that I wouldn't be against is clearly advertising/promotional/spam posts. If we had a thread system for these comments, so others can reply, they can point out mistakes/bad code/incorrect usage and those reading can learn what and what not to do. --00000000000050b506061ce83e35 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


=
On Wed, 10 Jul 2024 at 15:18, Derick = Rethans <derick@php.net> wrote:=
Hi!

There are currently nearly 20000 notes in the documentation, with many
having a very high negative rating.

For example, there are:

1131 notes older than a year, with a rating less than -10
2339 notes older than a year, with a rating less than -5
5761 notes older than a year, with a rating less than -1

The worst offender is:

https://www.php.net/manual/en/features.co= okies.php#128286 with -159 (not sure why the website says -153)
https://www.php.net/manual/en/l= anguage.attributes.overview.php#126887 with -104

We discussed this during one of our foundation meetings, and we propose:
- to delete all notes with a rating less than -5 that are older than a
=C2=A0 year.
- come up with a plan to crowd source going through the other thousands =C2=A0 of notes to see if they need to be deleted or integrated into the =C2=A0 actual text. Each documentation page now has a link to the XML sourc= e
=C2=A0 (such as https://github.com/= php/doc-en/blob/master/language/attributes.xml)

Comments?

cheers,
Derick


--
h= ttps://derickrethans.nl | https://xdebug.org | https://dram.io

Author of Xdebug. Like it? Consider supporting me: https://xdebug.org/supp= ort

mastodon: @derickr@phpc.social @xdebug@phpc.social

This is something im both For and Against.

On the for side, alot of these notes are negative rated for a rea= son, bad code, bad advice, incorrect usage, etc etc

But on the against said is removing information, no matter how bad the code is or misunderstood, in my eyes no information should be=20 removed. Let users see others' mistakes, so they dont repeat them.
This is what the rating system is for. The only stuff that I wouldn't b= e against is clearly
advertising/promotional/spam posts.

If we had a thread system for these= comments, so others can reply, they can point out mistakes/bad code/incorr= ect usage and those reading can learn what and what not to do.



--00000000000050b506061ce83e35--