Opened 16 years ago
Closed 16 years ago
#9371 closed enhancement (fixed)
Change excerpt info link to a Codex page for END users
Reported by: |
|
Owned by: | |
---|---|---|---|
Milestone: | 2.8 | Priority: | normal |
Severity: | normal | Version: | 2.8 |
Component: | Administration | Keywords: | has-patch commit |
Focuses: | Cc: |
Description
Currently, the decription in the Excerpt metabox links to a Codex article which is more for developers and tinkerers:
http://codex.wordpress.org/Template_Tags/the_excerpt
I started a Codex article with information for people who just want to USE the excerpt and learn what it does:
http://codex.wordpress.org/Excerpt
... and I am submitting a patch to link to that page instead.
Please, feel free to edit the Codex page — or to dismiss the idea of this patch completely, if you don’t agree. :-)
The Codex draft article is a super-condensed summary of an article I recently wrote about the manual Excerpt in WordPress:
Attachments (2)
Change History (9)
#2
@
16 years ago
Thanks for reviewing this!
The reason I made a new Codex page (and didn’t just add to the existing page) is that, I think, developer documentation and user documentation should be separate:
People use WordPress to manage content, not to write PHP functions. So, PHP code has no place in a page for *end users*.
Then, having PHP code in a page for end users gives a wrong impression, because you don’t need any of that stuff to *use* WordPress or, even, in this particular case, to take full advantage of the possibilities of the excerpt.
So, in my view, mixing dev docs with user docs is bad both for users (does not help them) and for WordPress (gives a wrong impression).
#4
@
16 years ago
- Keywords needs-patch added; has-patch removed
- Milestone changed from 2.8 to Future Release
patch is b0rke
#5
@
16 years ago
- Keywords has-patch added; needs-patch removed
- Milestone changed from Future Release to 2.8
Changes the info link for Excerpts to a Codex page for end users