[wp-trac] [WordPress Trac] #26879: Hello, new users. Here is an Error.

[WordPress Trac]

#26879: Hello, new users. Here is an Error.
-------------------------------------------------+------------------
 Reporter:  mrtortai                             |       Owner:
     Type:  enhancement                          |      Status:  new
 Priority:  normal                               |   Milestone:  3.9
Component:  Upgrade/Install                      |     Version:  3.0
 Severity:  normal                               |  Resolution:
 Keywords:  has-patch 2nd-opinion docs-feedback  |
-------------------------------------------------+------------------

Comment (by siobhan):

 This is awesome! I hate that page. You're totally right that it's off-
 putting to users. Thanks for opening the patch and giving it some love.
 I've got a few suggestions for text changes:

 1. Ditch the reference to "the core software" - that's quite a WP
 community way to talk about WordPress to distinguish the product from the
 rest of the community projects. It's not how a user would think of it.

 2. Ditch "welcome to the family" - it creeps me out a bit. I want to have
 a website, not join a family.

 3. I agree with nacin that some sort of explanation of setting up wp-
 config is important. However, we can make this a bit more user-friendly.

 4. I'm a bit concerned about linking to the Codex page. It's instantly
 scary (with the big red warning signs) http://codex.wordpress.org
 /Editing_wp-config.php That's more of a documentation flaw though. I know
 that you can only link to the documentation that we provide you with :(

 5. The preemptive error message on setup-config.php feels like it's in the
 wrong place (the "if for any reason this automatic file creation doesn't
 work...etc etc"). We're expecting that the user read that text, and absorb
 and remember it in case something goes wrong. However, it's more likely
 that the user will glance over it, fill in the database details, and not
 really think about it. It's when something actually goes wrong that they
 should get the information about how to fix it, not beforehand.

 6. I'm leaning towards removing "if you want to run more than one
 WordPress in a single database" (after table prefix on setup-config.php)
 as that seems like a more advanced technique and that person would already
 know how to install WP. That's just a thought that I'm throwing out there.

 7. Maybe at the end of the install process we could have some sort of call
 to action for people to get involved that links to the make site?

 Here are some suggestions. Feel free to peck at it to get what you want:

 wp-load.php

  WordPress is web software you can use to create a beautiful website,
 blog, or almost anything you can imagine.  WordPress is built by hundreds
 of volunteers, and there are thousands of plugins and themes available to
 transform your site.

 Reading back through this, I was thinking that if I'm installing
 WordPress, I'm already aware of what it is (i.e. I'm setting up my blog or
 whatever). It might make more sense to use this space to have a sort of
 teaser. Here's a suggestion for an alternative direction:

 wp-load.php

  In just a few minutes, you'll be all set up with WordPress and ready to
 create your own corner of the web. Transform your website with the
 thousands of plugins and themes available from right within WordPress.
 Write your blog, build your first website, launch your business, share
 your photos with your friends. You can do just about anything you can
 imagine.

 setup-config.php

   Before getting started, you need to configure WordPress. That means
 providing some information about your database. This information is
 available through your web host. If you don't have it, you'll need to get
 in touch with them. Here's what you need:
   Database name
   Database username
   Database password
   Database host
   Table prefix
   Once you fill in this information, WordPress will create a configuration
 file called wp-config.php. This connects WordPress with your database
 (that's where your content, settings, photos, and all that good stuff is
 stored).

--
Ticket URL: <https://core.trac.wordpress.org/ticket/26879#comment:6>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform