[wp-trac] [WordPress Trac] #30473: Inline Docs: Remove invalid markup from DocBlocks
WordPress Trac
noreply at wordpress.org
Mon Nov 24 07:41:14 UTC 2014
#30473: Inline Docs: Remove invalid markup from DocBlocks
--------------------------+---------------------
Reporter: DrewAPicture | Owner: rarst
Type: defect (bug) | Status: closed
Priority: high | Milestone: 4.1
Component: General | Version:
Severity: normal | Resolution: fixed
Keywords: has-patch | Focuses: docs
--------------------------+---------------------
Comment (by GaryJ):
It's good work, but there's still some inconsistencies. Even in r30543
alone, there's instances of:
* li element
* 'a' element
* `<a>`element.
The top one doesn't have any delimiter (wrong), and the second does, but
it isn't backticks so the end result isn't parsed marked up as `<code>`.
The last one is the most correct - the doc standard needs to clarify if
the instance of a tag needs to have angle brackets within the backticks or
not, and then apply that consistently.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/30473#comment:15>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list