Closed (fixed)
Project:
Drupal core
Version:
8.4.x-dev
Component:
documentation
Priority:
Normal
Category:
Bug report
Assigned:
Unassigned
Issue tags:
Reporter:
Created:
5 Jul 2017 at 21:54 UTC
Updated:
3 Aug 2017 at 13:49 UTC
Jump to comment: Most recent, Most recent file
Comments
Comment #2
shashikant_chauhan commentedAdding patch.
Comment #3
lomasr commentedPatch worked fine for me. Thanks
Comment #4
aburrows commentedAll the changes do are indent the comments..
Comment #5
joachim commentedThat might be all that is needed though?
The problem is not that anything is missing from the documentation, but that what is in the documentation isn't getting output on the API site. So it is a formatting problem, as API module is not picking up on the whole of the deprecation notice. Aligning it with the start of the notice looks like it could be the right fix.
Comment #6
shashikant_chauhan commentedHere is the example which shows the correct display when it's formatted/indented.
https://api.drupal.org/api/drupal/core%21includes%21entity.inc/function/...
Comment #7
joachim commentedThanks for the link!
Looking at the source of that function's docs to see how it's formatted (https://api.drupal.org/api/drupal/core%21includes%21entity.inc/8.2.x), I think the patch here fixes the problem.
Comment #8
gábor hojtsySo what is the issue on https://api.drupal.org/api/drupal/core%21includes%21entity.inc/function/... ? I see it displays the code example already as it should. What are we fixing here?
Comment #9
joachim commentedIt displays the code example in the main part of the docs, but not the code example in the deprecation notice. That just says:
and stops at 'use:'.
Comment #11
gábor hojtsyYou are right, I was looking at the wrong thing. Thanks for pushing this back.