Change excerpt info link to a Codex page for END users

[demetris]

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:

​http://op111.net/67

[demetris]

Changes the info link for Excerpts to a Codex page for end users

[Denis-de-Bernardy]

Suggesting wontfix and that the two codex pages be merged.

[demetris]

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).

[Denis-de-Bernardy]

patch is b0rke

[demetris]

Patch updated for r11262

[Denis-de-Bernardy]

+1 then. maybe a dev will pick this up and like it

[ryan]

(In [11267]) Better excerpt text and linkage. Props demetris, Denis-de-Bernardy. fixes #9371