We need a nice intro. I've been avoiding it cause I'm not really sure what should go there, any thoughts on what should be said there? Any thing will be better than my 'Intro to oop 5' :) Perhaps one of the things on the first page is the basic concept on how to create a class and extending a class.
Current sections that need content, limited to sections defined:
- Object Constants
- Object Interfaces - Overloading
- Object Iteration
- Magic Methods
- Final keyword
The only section that isn't listed in the current structure is Exceptions. If, however, the oop5 documentation is going to be more on the idea that they have no clue about php4 oop then we need: - class creation - extending classes
One way to aproach this is to have a 'Intro to OOP with PHP', which will
define the basics that are common between the both 4 and 5. Like class creation and extending a class. On second thought this might not be a good
idea since member and method declartion are completely different.
We need separate PHP 4 and PHP 5 intro sections, since they will be very much different. We do have this for PHP 4 IMHO, it just needs to be taken as an example for PHP 5. Well, the cart example might be changed for something more exciting :))
Consistancy issues:
Right now we have the title's of stuff that vary a lot. Some are prefixed with 'Object' other's have the word 'Keyword' appended.
I'm thinking we should get rid of those pre and post words and
just do stuff like:
Constants
Abstraction
...
The only two I don't see that fit that naming scheme are final and static, they don't make sense to me without some sort of text
around them.
It is nice to have helper words when the meaning of something is not clear. Like you would not remove 'methods' from after 'magic' :) or you would not remove 'objects' after 'comparing', since the 'comparing' word alone would not provide much clue on what is going on.
What to do with the built in classes and implementations:
Like implementing Iterator (and all that SPL stuff if applicable) extending the Exception class etc.
I don't understand the question. Built in classes should be at the relevant appendix. Iterators and Exceptions should have their own parts otherwise: iterators under the OOP 5 part where they are currently, exceptions on the language reference level as a new section.
The Title's for PHP4 vs PHP5: Although very low priority right now, on my browser the left navigation line breaks in between the words and looks horrible. This might be more of an issue of how the left nav vertical alignment is displayed.
Low priority, yes...
Goba
