Getting started with improving the manual
| From: | Jakob Givoni | Date: | Sun, 17 May 2020 16:17:31 +0000 |
| Subject: | Getting started with improving the manual | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969387528@lists.php.net to get a copy of this message | ||
Hi there,
I understand this is the list where we discuss the PHP documentation
and how to improve it.
I would like to get started fixing reported bugs:
https://bugs.php.net/search.php?limit=30&order_by=id&direction=DESC&cmd=display&status=Open&bug_type=Documentation+Problem
I've studied this page on how to get started:
https://www.sitepoint.com/how-to-contribute-to-phps-documentation/
I've also submitted my first patch using the online editor - Doc #79597
I see a patch similar to mine has been merged, but I'm not sure if
it's mine or someone else fixing it around the same time.
Let's start with the questions:
- Can I pick any bug and submit a patch or should I only pick verified ones?
- Is it possible to assign a bug first so two people don't waste time
fixing the same one?
- If I have questions about how best to fix a bug, can I ask you guys
here, or should we use comments in the bugs themselves?
- There's a bug report on constants:
https://bugs.php.net/bug.php?id=79141 - the
conclusion is that the
page on "constants" doesn't clarify that functions are not allowed in
constant expressions, but actually,
https://www.php.net/manual/en/language.constants.php
doesn't even
mention declaring constants using the "const" keyword. This
information is on
https://www.php.net/manual/en/language.oop5.constants.php
which does
say that function calls are not permitted. What is the fix here? Add
explanation about "const" on the main "constants" page, or link to the
class constants page? Btw, why does a search on "const" not result in
ANY matches?
Thank you for getting me started!
Jakob