Closed (fixed)
Project:
Drupal core
Version:
8.0.x-dev
Component:
documentation
Priority:
Normal
Category:
Task
Assigned:
Unassigned
Issue tags:
Reporter:
Created:
13 Dec 2011 at 23:03 UTC
Updated:
29 Jul 2014 at 20:14 UTC
Jump to comment: Most recent, Most recent file
Comments
Comment #1
jhodgdonSounds reasonable. Just needs a patch -- probably good Novice project.
Comment #2
jvns commentedComment #3
chris.leversuch commentedI think @see should be at the end of the doc header
Comment #4
jvns commentedI thought so too, but everywhere elsewhere in taxonomy.module @see is before @param, so I went with that. Not clear to me what the right thing to do is. (fix it everywhere?)
Comment #5
jhodgdonWe're in the midst of cleaning up the Drupal 8 documentation so it conforms with our standards on this issue:
#1310084: [meta] API documentation cleanup sprint
The taxonomy module hasn't been done yet, and moving the @see to the end of the doc blocks is one of the cleanup tasks.
For this issue, please just do these functions right, and don't clean up the rest of the file. But if you're interested in cleaning up, you can join in the cleanup issue -- there are instructions there. :)
By the way, standards for how to do doc headers correctly are at:
http://drupal.org/node/1354
Comment #6
chris.leversuch commentedNew patch with @see at the bottom
Comment #7
xjmThis looks correct. Thanks!
Comment #8
xjmComment #9
webchickLooks good! Committed and pushed to 8.x and 7.x. Thanks.