Hi Peter,
I'm afraid I don't agree with a number of your points. I'll expand below:
Peter Stewart wrote:
Good point Tom, so I propose not to separate wp and mu function
references in their naming, as they are all function references, ie:
http://codex.wordpress.org/Function_Reference/wpmu_function_name
They are all function references, but of two distinct applications. See
further comments below.
This page should remain:
http://codex.wordpress.org/WPMU_Function_Reference (currently called
WPMU_Functions)
Renaming it seems reasonably sensible, but at the same time I think it
would need to be refactored to be similar to the main function reference
-- at the moment it's not much of a reference, just a list! Splitting
functions up into categories would make it much more user friendly.
Or even just include this as a smaller section at the bottom of
http://codex.wordpress.org/Function_Reference
Absolutely not. WPMU and WP keep separate codebases -- they are not
currently the same thing. Mixing the functions up may well lead to
confusion amongst developers new to WP who might think that those
functions are available to them. They should be distinct from the
functions bundled in WP for as long as MU is distinct from the main WP
codebase.
This category should remain:
http://codex.wordpress.org/Category:WPMU_Functions
There will be no confusion putting prefixing Function_Reference on
both because wpmu pages would be in Category:WPMU_Functions and listed
in WPMU_Function_Reference page.
This also simplifies the naming. ALL functions (mu or regular) would
be Function_Reference/function_name, because they are all function
references, but the categories tell them apart.
I disagree. Mixing the functions up will cause confusion. Categories
are only listed at the bottom of each page, and I would even go so far
as to suggest that the majority of 'normal' users aren't really aware of
their existence. It's very helpful to have that kind of information in
the page title (not to mention having it in the address bar itself!),
and as the title is derived from the URL I don't think this should be
changed.
This also places WPMU more as an extension of WP, rather than
something separate.
Which, in my opinion, is wrong. Until the two are merged it's a
different thing and we shouldn't muddle it all together
Cheers,
Peter
C.
On Tue, Nov 10, 2009 at 17:56, Tom Lynch <[email protected]> wrote:
My only issue is that then you would have to type
http://codex.wordpress.org/WPMU_Functions/WPMU_get_blog_options
Which is unnessisary I personally would say no to the prefixing because it
is duplicating information.
However that's just me.
That said for normal pages it's a great idea I had thought that renaming
functions to function reference would ad more continuity and if that page
were laid out the same that would be good too.
Kind Regards
Tom Lynch
++++++++++++++++++++++++
T: +44 (0)7786 540 167
E: [email protected]
++++++++++++++++++++++++
On 9 Nov 2009, at 09:36, Peter Stewart <[email protected]> wrote:
Hey, Peter here (Pumpkinslayer)
First time in here so hello. I'm a long-time WPMU user. The biggest
project was a hack of Dr. Dave's anti-spam ported to MU (yes, a while
back). I do still run all my domains off a single install of MU. I've
done very little hacking in the last 3 years, but am keen on editing
and tightening up documentation.
Chiming in on the WPMU Functions thread that came up last month.
I would suggest naming the WPMU Functions in the same way as the main
WordPress content.
In the standard version there are...
Function_Reference (lists all functions)
Function_Reference/function_name (describes functions)
Category:Functions (category)
There are already a ton of pages for WPMU but I'd suggest naming like
this:
WPMU_Function_Reference (lists all functions)
WPMU_Function_Reference/function_name (describes function)
Category:WPMU_Functions (category)
I recommend prefixing WPMU_ on all the MU stuff. I don't know how
Wikimedia handles page name changes in terms of redirection, but this
is my suggestion (I won't jump in and change them, that's too big a
spanner in the works in one go)
Ideas, opinions and suggestions please.
Thanks,
Peter
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs
