[wp-docs] The main page.

[Mika A Epstein]

It sounds like Andrea's saying we should focus on 'How WordPress.org installs work' rather than 'How WordPress.com works.'

Yes, there's a tonne of crossover, and there are some .com docs we could lift wholesale and be happy about, but there's a lot that you CANNOT do on .com (install a plugin) and vice versa (there are some admin screens that are surprising the first time you see them).

A doc on 'So you've come here from .com…' would be sensible.

A how to use .com would not be.

This goes the same for people on Page.ly, which IIRC provides a limited MultiSite install for people to use.  We can't really help them, though some of the docs will be of interest. They're not the target.  The target is people who are installing (via one click or whatever) WordPress.org software on a server.

I'm not opposed to 'how to' docs in general, though the codex has been a documentation repository, and if we were to change it to a tutorial site, that's okay, but we have to manage to support BOTH tracks at that, and I'm not sure we're supporting one, to be honest.  We have to be cautious going down the tutorial slope, and there's already http://learn.wordpress.com/ - Maybe a learn.wordpress.org would be better served as a separate site. Leave the codex for pure documentation, with in-line examples.

----
Mika A Epstein (aka Ipstenu)
http://ipstenu.org

On 29 Aug 2011, at 5:21:14PM, Andrea Rennick wrote:

> I was referring specifically to training material for users hosted on someone else's network installation. Whomever hosted the person needs to support them - not the codex.
> 
> I'm perfectly fine with a section explaining, for example "here's what users in a network experience". that's quite different, as someone setting up a network of sites can offer a multitude of plugins & themes for their users, each different from the next host.
> 
> Think of it this way - if that same user, hosted on Joe's multisite network, is paying Joe to host him, if they show up in the wp.org forums looking for help, not only is there nothing I can do to help him, I have no idea what options he has available.
> 
> And if it were me in change of a network, and my users were showing up in the wp.org forums looking for help? Yes, I'd want them pointed back to me.
> 
> You can use wordpress.com as an example there too - while it's mentioned in the codex, the codex is not the place for support docs for those users. The codex is for documentation for people *running* the network.
> 
> A.
> 
> On Mon, Aug 29, 2011 at 7:15 PM, Spencer Hill <spencerhill at theportlandco.com> wrote:
> Andrea, I would like to hear your argument for not including training materials in the codex. At first, training materials did seem a bit abstract to me in the codex (because I primarily use it for researching functions), but there is definitely training materials pre-existing in it to date, and obviously there does need to be a location for training materials. But if you and others think we could separate training from the whatever would be in the codex I could see that being a potential solution to this question.
> 
> m3shroom, thanks for the example - that makes sense to me!
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs
> 
> 
> 
> -- 
> -- 
> Andrea Rennick, http://wpebooks.com and http://ronandandrea.com 
> Co-author of WordPress All-In-One For Dummies http://rml.me/aio
> 
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs