#1547 closed defect (bug) (invalid)
New style docs are not editable
Reported by: | theMikeD | Owned by: | |
---|---|---|---|
Milestone: | Priority: | normal | |
Component: | Developer Hub | Keywords: | |
Cc: |
Description
The new docs pages don't seem to be editable like the old ones are. Is this by design?
Example: https://developer.wordpress.org/reference/functions/wp_enqueue_script/
Change History (7)
#3
@
9 years ago
Was there effort made to ensure that the content present on the old pages is present in the php docblock on a function-by-function (filter, action, etc) basis? If not, how can we see the old page to compare to the new one to ensure information parity?
#4
@
9 years ago
For example: https://codex.wordpress.org/Template_Tags/get_posts is quite detailed. The docblock for get_posts is not, and neither is the new doc page for get_posts https://developer.wordpress.org/reference/functions/get_posts/ . In this particular case, it's worse than incomplete because it provides a subset of the actual arguments as if it was a complete list.
How will the current information be preserved? Does the entire current codex page really need to be put into the docblock? How should code fragments be formatted?
#6
@
9 years ago
- Resolution set to invalid
- Status changed from reopened to closed
There is an ongoing effort to migrate the data. If you'd like to join, pop into #docs in Slack and get involved. Once the data is migrated, we redirect the Codex page.
Devhub pulls data from the inline docs in core. If an inline doc is incorrect, you can file a core ticket to fix.
The User Contributed Notes can be submitted by anyone who's logged in.