Welcome to the official home of the WordPress Documentation Team.
This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.
Want to get involved?
Start here to find out more about what we do and how to contribute:
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/
Weekly meetings
Join our discussions of documentation issues here on the blog and on Slack.
If all goes to plan, WordPress 3.5 will be with us in a just over a weeks. This means that the Codex is going to need to be updated in line with the new features. To help keep track of what needs to be updated, I thought it would be a good idea to create a list. I’d love some help creating the list of items that need to be reviewed and/or updated. Just note the item in the comments, with or without a link to the relevant codex page.
Sprint happening on 13th December: see here: https://make.wordpress.org/docs/2012/11/30/this-release-cycle-were-lucky-enough-to-know/
Using Themes https://codex.wordpress.org/Using_Themes (@raggedrobins)
Add to glossary https://codex.wordpress.org/Glossary (@raggedrobins)
Child Themes page uses Twenty Eleven as Example: https://codex.wordpress.org/Child_Themes (@raggedrobins)
Update reference to default theme: https://codex.wordpress.org/Common_WordPress_Errors (@raggedrobins)
Updating WordPress: https://codex.wordpress.org/Updating_WordPress (this page needs totally rewritten – suggest having another sprint for updating out of date pages) (@raggedrobins)
#HTMLHTMLHTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites. Editor renamed as Text:
This post on wpbeginner: http://www.wpbeginner.com/wp-themes/how-to-set-oembed-max-width-in-wordpress-3-5-with-content_width/ This could be added to one of the troubleshooting FAQs – “How do I resize my oembeds?” (@DrewAPicture)
#PluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party Favorites: – Philip Erb
turned off by default: https://codex.wordpress.org/AtomPub Can re-enable with a plugin: https://wordpress.org/extend/plugins/atom-publishing-protocol/ (@raggedrobins)
#MultisiteMultisiteMultisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network.
Multisite installs now work with WordPress in a subdirectory (@Ipstenu)
Rockstar: Turn off ms-files.php by default (@Ipstenu)
Widgets menu hidden if no sidebar is active (maybe add an FAQ to the troubleshooting guide?) https://codex.wordpress.org/WordPress_Widgets (@raggedrobins)
Display name defaults to first name and last name for new users https://codex.wordpress.org/Users_Screen also: https://codex.wordpress.org/Users_Your_Profile_Screen#Your_Profile_and_Personal_Options (@raggedrobins)
Force the user to explicitly choose between content deletion and reassignment when deleting users https://codex.wordpress.org/Users_Screen#Delete_Users (@raggedrobins)
changes to custom headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. screen (@raggedrobins)
Easier Expression of Time constants (new!) https://codex.wordpress.org/Transients_API#Using_Time_Constants (@DrewAPicture)
Developer
General Developer
Bump default memory limit from 32MB to 40MB (@raggedrobins)
Add easier expression of time constants, for example DAY_IN_SECONDS vs 86400 (@DrewAPicture)
Add flexible-header to allowed theme tags
Add ‘publish_post’ metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. capability (@DrewAPicture)
No Class Reference: Add ‘term_taxonomy_id’ field handling to WP_Tax_Query::transform_query(), resulting in fewer database queries
Add two hooksHooksIn WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. to Post Editing screen, ‘edit_form_after_title’ and ‘edit_form_after_editor’ [more info] (@DrewAPicture)
Rockstar: Allow ordering posts by IDs passed to ‘post__in’
Check a post type’s ‘show_in_admin_bar’ property for ‘View’ and ‘Edit’ object Toolbar links
Rockstar: Introduce wp_cache_switch_to_blog() and WP_Object_Cache::switch_to_blog() to more efficiently switch the cache to a new blog id
Rockstar: Introduce WP_Image_Editor class, abstracting GD from coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress., and introducing Imagick support
Deprecate image_resize filterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. (@sirjonathan)
Deprecate image_save_pre filter, which filters a GD Resource, for image_editor_save_pre, which filters a WP_Image_Editor object (@sirjonathan)
Deprecate wp_save_image_file filter, which filters a GD Resource, for wp_save_image_editor_file, which filters a WP_Image_Editor object (@sirjonathan)
Deprecate image_edit_before_change filter, which filters a GD Resource, for image_edit_before_change, which filters a WP_Image_Editor object (@DrewAPicture)
Deprecate jpeg_quality filter for wp_editor_set_quality, or WP_Image_Editor::set_quality() on an individual image, which sets compression quality for any supported format (@sirjonathan)
Deprecate wp_load_image() in favor of wp_get_image_editor() https://codex.wordpress.org/Function_Reference/wp_load_image (@raggedrobins)
Deprecate image_resize in favor of WP_Image_Editor::resize() (@raggedrobins)
Deprecate gd_edit_image_support() in favor of wp_image_editor_supports() (@raggedrobins)
register_taxonomy page needs to be updated with the new ‘show_admin_column’ parameter that allows automatic creation of taxonomyTaxonomyA taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. columns on associated post-types. (@Ramly)
Add ‘order’ parameter to wp_get_archives() https://codex.wordpress.org/Function_Reference/wp_get_archives (@DrewAPicture)
Allow count_many_users_posts() to count only public posts (@jhoffm34)
Allow passing stdClass and WP_User to wp_insert_user() and wp_update_user() (@DrewAPicture)
Fix the matching in is_email_address_unsafe(), which was too aggressive (@DrewAPicture)
Give System temporary directories preference in get_temp_dir() for better Windows compatibility (@DrewAPicture)
Hide UIUIUI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing. for attachment taxonomies if ‘show_ui’ is ‘false’ for that taxonomy (@DrewAPicture)
Make get_home_path() work in more cases by being case insensitive and sanitzing Windows paths (@DrewAPicture)
No markup is output if wp_nav_menu() has no menu items (@DrewAPicture)
Return WP_Error object if the database insert in wp_set_object_terms() fails (@DrewAPicture)
Simplify protocol stripping in add_query_arg() by avoiding a regular expression (@DrewAPicture)
supports => false can be passed to register_post_type() to disable default title and editor (@DrewAPicture)
Welcome Panel and accompanying screen option removable via the welcome_panel hook (@DrewAPicture)
When reassigning posts and links during user deletion, clear the post and link caches
Rockstar: XML-RPC: Add the ‘home’ option to wp.getOptons https://codex.wordpress.org/XML-RPC_WordPress_API/Options
Rockstar: XML-RPC: Don’t use switch_to_blog() in wp.getUsersBlogs, improves performance and memory footprint https://codex.wordpress.org/XML-RPC_wp
Add jQuery Masonry for better custom header listings (@raggedrobins)
Farbtastic color picker replaced with Iris color picker [more info] (@raggedrobins)
Switch to .min for compressed JS and CSSCSSCSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site. files, e.g. .js becomes .min.js, .dev.js becomes .js (@DrewAPicture)
Allow protocol-relative URLs when registering/enqueueing scripts and styles (@georgestephanis)
Prototype and Script.aculo.us local libraries unbundled from core, latest versions enqueued via ajax.googleapis.com (@raggedrobins)