[wp-docs] WPMU Functions and hi

[Carreg]

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 <me at unknowndomain.co.uk> 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: me at unknowndomain.co.uk
>>
>> ++++++++++++++++++++++++
>>
>> On 9 Nov 2009, at 09:36, Peter Stewart <peter at peterandava.com> 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
>>> wp-docs at lists.automattic.com
>>> http://lists.automattic.com/mailman/listinfo/wp-docs
>>>       
>> _______________________________________________
>> wp-docs mailing list
>> wp-docs at lists.automattic.com
>> http://lists.automattic.com/mailman/listinfo/wp-docs
>>     
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs
>