Fix: Add more clarity

README.md

@@ -1,4 +1,5 @@
 # WordPress Advanced Administration Handbook
+
 This is the repository for the **WordPress Advanced Administration Handbook** a collaboration between the Hosting Team and the Documentation Team.
 
 The **WordPress Advanced Administration Handbook** will be a new section in the "Hub" [developer.wordpress.org](https://developer.wordpress.org/) where all the most technical documentation for users and developers will be moved, so the documentation will be simple, and this one will have code and be more complex.
@@ -11,86 +12,7 @@ The **WordPress Advanced Administration Handbook** will be a new section in the
 - [Handbook](https://github.com/WordPress/Advanced-administration-handbook)
 - [Meta ticket](https://meta.trac.wordpress.org/ticket/6411)
 
-The future URL for this handbook will be at [https://developer.wordpress.org/advanced-administration/](https://developer.wordpress.org/advanced-administration/) (by [Meta ticket](https://meta.trac.wordpress.org/ticket/6411)).
-
-## Roadmap
-
-- [x] Phase 0: Create an initial structure to understand the categorization.
-- [x] Phase 1: Create the empty-files with a link inside, so there is all the structure.
-- [x] Phase 2: Add the content (only copying from the original page and create the content structure).
-- [x] Phase 3: Publish a first version of the Advanced Admin Documentation.
-- [ ] Phase 4: Check and improve the content.
-
-## File Structure
-
-Based on [WordPress Advanced Administration Handbook](https://docs.google.com/document/d/1fVIw3DztzyVY18RDPCGk-kDYTO6gzHtx81o7aitGijo/)
-
-- [README](README.md)
-- [LICENSE](LICENSE)
-- [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md)
-- [WordPress Advanced Administration Handbook](index.md) ([🔗](https://developer.wordpress.org/advanced-administration/))
-  - [Before You Install](before-install/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/))
-    - [Creating Database for WordPress](before-install/creating-database.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/creating-database/))
-    - [How to install WordPress](before-install/howto-install.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/howto-install/))
-    - [Running a Development Copy of WordPress](before-install/development.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/development/))
-    - [Installing WordPress in your language](before-install/in-your-language.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/in-your-language/))
-    - [Installing Multiple WordPress Instances](before-install/multiple-instances.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/multiple-instances/))
-    - [Install WordPress at popular providers](before-install/popular-providers.md) ([🔗](https://developer.wordpress.org/advanced-administration/before-install/popular-providers/))
-  - [Server configuration](server/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/))
-    - [Changing File Permissions](server/file-permissions.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/file-permissions/))
-    - [Finding Server Info](server/server-info.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/server-info/))
-    - [Giving WordPress Its Own Directory](server/wordpress-in-directory.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/wordpress-in-directory/))
-    - [Configuring Wildcard Subdomains](server/subdomains-wildcard.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/subdomains-wildcard/))
-    - [Emptying a Database Table](server/empty-database.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/empty-database/))
-    - [Web servers](server/web-server.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/web-server/))
-      - [nginx](server/nginx.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/web-server/nginx/))
-    - [Control Panels](server/control-panel.md) ([🔗](https://developer.wordpress.org/advanced-administration/server/control-panel/))
-  - [WordPress configuration](wordpress/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/))
-    - [wp-config.php](wordpress/wp-config.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/wp-config/))
-    - [Site Architecture](wordpress/site-architecture.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/site-architecture/))
-    - [Cookies](wordpress/cookies.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/cookies/))
-    - [Update Services](wordpress/update-services.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/update-services/))
-    - [Editing Files](wordpress/edit-files.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/edit-files/))
-    - [CSS](wordpress/css.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/css/))
-    - [Feeds](wordpress/feeds.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/feeds/))
-    - [Multilingual WordPress](wordpress/multilingual.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/multilingual/))
-    - [oEmbed](wordpress/oembed.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/oembed/))
-    - [Loopbacks](wordpress/loopback.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/loopback/))
-    - [Common errors](wordpress/common-errors.md) ([🔗](https://developer.wordpress.org/advanced-administration/wordpress/common-errors/))
-  - [Upgrading / Migration](upgrade/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/upgrade/))
-    - [FTP Clients](upgrade/ftp.md) ([🔗](https://developer.wordpress.org/advanced-administration/upgrade/ftp/))
-      - [Using FileZilla](upgrade/filezilla.md) ([🔗](https://developer.wordpress.org/advanced-administration/upgrade/ftp/filezilla/))
-    - [phpMyAdmin](upgrade/phpmyadmin.md) ([🔗](https://developer.wordpress.org/advanced-administration/upgrade/phpmyadmin/))
-    - [Upgrading](upgrade/upgrading.md) ([🔗](https://developer.wordpress.org/advanced-administration/upgrade/upgrading/))
-    - [Migration](upgrade/migrating.md) ([🔗](https://developer.wordpress.org/advanced-administration/upgrade/migrating/))
-  - [WordPress Multisite / Network](multisite/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/))
-    - [Before You Create A Network](multisite/prepare-network.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/prepare-network/))
-    - [Create A Network](multisite/create-network.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/create-network/))
-    - [WordPress Multisite Domain Mapping](multisite/domain-mapping.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/domain-mapping/))
-    - [Multisite Network Administration](multisite/administration.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/administration/))
-    - [Network Admin](multisite/admin.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/admin/))
-    - [Migrate WordPress sites into WordPress Multisite](multisite/sites-multisite.md) ([🔗](https://developer.wordpress.org/advanced-administration/multisite/sites-multisite/))
-  - [Plugins](plugins/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/plugins/))
-    - [Must Use Plugins](plugins/mu-plugins.md) ([🔗](https://developer.wordpress.org/advanced-administration/plugins/mu-plugins/))
-  - [Themes](themes/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/themes/))
-  - [Security](security/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/))
-    - [Your password](security/logging-in.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/logging-in/))
-    - [Multi-Factor Authentication](security/mfa.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/mfa/))
-    - [Backups](security/backup.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/backup/))
-      - [Database Backup](security/backup.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/backup/database/))
-      - [Files Backup](security/backup.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/backup/files/))
-    - [HTTPS](security/https.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/https/))
-    - [Brute Force Attacks](security/brute-force.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/brute-force/))
-    - [Hardening WordPress](security/hardening.md) ([🔗](https://developer.wordpress.org/advanced-administration/security/hardening/))
-  - [Performance / Optimization](performance/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/performance/))
-    - [Cache](performance/cache.md) ([🔗](https://developer.wordpress.org/advanced-administration/performance/cache/))
-    - [Optimization](performance/optimization.md) ([🔗](https://developer.wordpress.org/advanced-administration/performance/optimization/))
-  - [Debugging WordPress](debug/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/debug/))
-    - [Debugging in WordPress](debug/debug-wordpress.md) ([🔗](https://developer.wordpress.org/advanced-administration/debug/debug-wordpress/))
-    - [Debugging a WordPress Network](debug/debug-network.md) ([🔗](https://developer.wordpress.org/advanced-administration/debug/debug-network/))
-    - [Using Your Browser to Diagnose JavaScript Errors](debug/debug-javascript.md) ([🔗](https://developer.wordpress.org/advanced-administration/debug/debug-javascript/))
-    - [Test Driving WordPress](debug/test-driving.md) ([🔗](https://developer.wordpress.org/advanced-administration/debug/test-driving/))
-  - [Resources](resources/index.md) ([🔗](https://developer.wordpress.org/advanced-administration/resources/))
+The URL for this handbook is at [https://developer.wordpress.org/advanced-administration/](https://developer.wordpress.org/advanced-administration/).
 
 ## Recommendations
 
@@ -106,7 +28,7 @@ Based on [WordPress Advanced Administration Handbook](https://docs.google.com/do
 
 ### External linking
 
-- [External Linking Policy – "Commercial blogs"](https://make.wordpress.org/docs/2020/07/06/external-linking-policy-commercial-blogs/)
+- [External Linking Policy (Summary)](https://make.wordpress.org/docs/handbook/documentation-team-handbook/external-linking-policy/)
 
 ### Example domains
 

before-install/creating-database.md

@@ -1,6 +1,6 @@
 # Creating Database for WordPress
 
-If you are installing WordPress on your own web server, follow the one of below instructions to create your WordPress database and user account.
+If you are installing WordPress on your own web server, follow one of the below instructions to create your WordPress database and user account.
 
 ## Using phpMyAdmin
 
@@ -24,7 +24,7 @@ phpMyAdmin Users Tab
 
 1. Click **Add user**.
 2. Choose a username for WordPress ('wordpress' is good) and enter it in the **User name** field. (Be sure **Use text field:** is selected from the dropdown.)
-3. Choose a secure password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and enter it in the **Password** field. (Be sure **Use text field:** is selected from the dropdown.) Re-enter the password in the **Re-type**field.
+3. Choose a secure password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and enter it in the **Password** field. (Be sure **Use text field:** is selected from the dropdown.) Re-enter the password in the **Re-type** field.
 4. Write down the username and password you chose.
 5. Leave all options under **Global privileges** at their defaults.
 6. Click **Go**.
@@ -48,12 +48,12 @@ Your MySQL connection id is 5340 to server version: 3.23.54
 Type 'help;' or '\\h' for help. Type '\\c' to clear the buffer.  
 
 mysql> CREATE DATABASE databasename;  
-Query OK, 1 row affected (0.00 sec)  
-  
-mysql> GRANT ALL PRIVILEGES ON databasename.* TO "wordpressusername"@"hostname"
-\-> IDENTIFIED BY "password";  
-Query OK, 0 rows affected (0.00 sec)  
-  
+Query OK, 1 row affected (0.00 sec)
+
+mysql> CREATE USER "wordpressusername"@"hostname" IDENTIFIED BY "password";
+mysql> GRANT ALL PRIVILEGES ON databasename.* TO "wordpressusername"@"hostname";
+Query OK, 0 rows affected (0.00 sec)
+
 mysql> FLUSH PRIVILEGES;  
 Query OK, 0 rows affected (0.01 sec)   
 
@@ -73,7 +73,7 @@ If you need to write these values somewhere, avoid writing them in the system th
 
 ## Using Plesk
 
-If your hosting provider supplies the [Plesk](http://www.plesk.com/) hosting control panel and you want to install WordPress manually, follow the instructions below to create a database:
+If your hosting provider supplies the [Plesk](https://www.plesk.com/) hosting control panel and you want to install WordPress manually, follow the instructions below to create a database:
 
 1. Log in to Plesk.
 2. Click **Databases** in the Custom Website area of your website on the Websites & Domains page:  
@@ -102,7 +102,3 @@ If you're a regular User of a single-site webhosting account, you can log in nor
 Reseller accounts Admin accounts may need to click **User Level**. They must first log in as Reseller if the relevant domain is a Reseller's primary domain… or log in as a User if the domain is not a Reseller's primary domain. If it's the Reseller's primary domain, then when logged in as Reseller, simply click **User Level**. However if the relevant domain is not the Reseller's primary domain, then you must log in as a User. Then click **MySQL Management**. (If not readily visible, perhaps you need to return to the Reseller or Admin level, and modify the “Manage user package” or “Manage Reseller package” to enable MySQL.)
 
 In MySQL Management, click on the small words: **Create new database**. Here you are asked to submit two suffixes for the database and its username. For maximum security, use two different sets of 4-6 random characters. Then the password field has a Random button that generates an 8-character password. You may also add more characters to the password for maximum security. Click **Create**. The next screen will summarize the database, username, password and hostname. Be sure to copy and paste these into a text file for future reference.
-
-## Changelog
-
-- 2022-09-11: Original content from [Creating Database for WordPress](https://wordpress.org/documentation/article/creating-database-for-wordpress/).