How to update docs
| From: | Ryan Pallas | Date: | Fri, 24 Apr 2015 15:25:02 +0000 |
| Subject: | How to update docs | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969385593@lists.php.net to get a copy of this message | ||
Hi PHP Doc people,
I was wondering if someone could help me to get an update to the manual
through? I've noticed today that the Class Constants page (
http://php.net/manual/en/language.oop5.constants.php)
doesn't make any
mention of the new Constant Expressions feature added in 5.6. And while it
is mentioned on the new features page for 5.6 (
http://php.net/manual/en/migration56.new-features.php)
I feels like the
pages affected by new features should also be updated.
To me this is important to make sure dev looking up this information have
all the information. IE; someone new coming in to PHP want to look up how
class constants work, so they go to that page in the OOP section and find
that only scalar literals are allowed. But in fact, so are scalar
expressions in the newest version. They might never find this information
since its hidden away in the new features section of the docs. Or they
might not realize that being allowed to do it on global constants, means
they can do it on class constants (if they happen to go to that page as
well)
As such, I've gone to edit.php.net (per the instructions I found) and tried
to edit the page. However it shows up in the All Files list in red, and
doesn't let me save changes to create a pull request. Am I missing
something obvious here? I don't see anything on the wiki about files being
in red.
Thanks for you time,
-Ryan