Getting started with improving the manual
Jakob Givoni <[email protected]>
| Newsgroups | gmane.comp.php.documentation.general |
|---|---|
| Message-ID | <CAJmjfvVbZdtz4FjMBXHcj6niwQN+Gsq2TNiXXA_XfeOE1q5QYg@mail.gmail.com> |
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