Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.Much of the Drupal 7 functionality is now in PHP classes.
api.drupal.org does not currently display, index, or otherwise support PHP classes. And won't until #300031: Rework PHP parser is fixed. (See http://drupal.org/node/300031#comment-2107014).
Since api.drupal.org is such a critical resource to Drupal developers, I would advocate for not releasing Drupal 7 until api.drupal.org has the capacity to adequately reflect the Drupal API, which it won't until it can deal with PHP classes.
Comments
Comment #1
joachim CreditAttribution: joachim commented+1
The quality of Drupal's API documentation is a strong point. We shouldn't let standards drop.
Comment #2
jhodgdonYeah. Check out how many issues on the API project and Drupal / component Doc are marked as duplicates of #300031: Rework PHP parser to get an idea of how many people think this is a critical issue. Here's one I marked today:
#581052: no class documentation
Comment #3
eikes CreditAttribution: eikes commented+1 I fully agree
Comment #4
wasare CreditAttribution: wasare commented+1
Comment #5
sun.core CreditAttribution: sun.core commentedWell, we are aware of this problem, but I don't think we should count this as a critical issue.
Comment #6
jhodgdonIt's actually a critical issue, since it's a release blocker.
Comment #7
klausiThe API module follow up on integrating classes is here: #710774: Ensure all class-related items are parsed
Comment #8
jhodgdonStatus should stay as "active". Needs work is used when there's a patch to review on this issue that needs fixing.
Comment #9
catch#757568: Add UI pages for classes looks to be the most current issue dealing with this.
Comment #10
jhodgdonYes. Also related to this issue:
#718576: [Meta] API documentation for classes and interfaces is incomplete
#718596: Lacking standards for documenting classes, interfaces, methods
Comment #11
Anonymous (not verified) CreditAttribution: Anonymous commentedA critical bug report documentation issue... As nice as it would be to have this updated, shouldn't this be more of a normal documentation task issue for the infrastructure? I have my doubts that this should be a critical issue or a bug report.
Comment #12
catchIMO this is 'release checklist' not 'release blocking bug' - but we don't have a major core version release checklist. i.e. we might want this to block release, but it shouldn't block an RC. Not sure how to deal with that though.
Comment #13
jhodgdonHopefully we will have this taken care of in the next few weeks, so you won't have to worry about whether it's critical or not. :)
Comment #14
catchPer discussion with webchick, moving this to the 7.0 release checklist, see http://drupal.org/project/drupal
Comment #15
my.wahyu CreditAttribution: my.wahyu commentedI pledge to have a Comment Opened on the day that Drupal 7 is released.
But I'm still use Drupal 7 Alpha 6 as Live Site.
But Comment, and everything that connecting with API, file.inc, Stream. Wrapper, register function are closed.
Waiting Drupal 7 Stable Version is released. ASAP, First Appearance is Amaazing.
Comment #17
apadernoI am removing the issue tags added in the previous comment.
Comment #18
klausihttp://api.scratch.drupal.org/api/drupal/classes/7 looks good, when will it be rolled out to api.drupal.org?
Comment #19
jhodgdonIf you check the API module's issue queue at http://drupal.org/project/issues/api, you will see that there are still a couple of issues holding up the deployment. The main one right now is that we want old links to locations on api.drupal.org to redirect to the new URLs that will be in effect when the new code is deployed. But you can follow the progress there. Or better yet, see if you can help. :)
Comment #20
frobscribing
Comment #21
LaurentAjdnik CreditAttribution: LaurentAjdnik commentedTagging
Comment #22
EvanDonovan CreditAttribution: EvanDonovan commented@jhodgdon: Is there a tag being used on the API queue to indicate the issues blocking rollout of the new api.drupal.org, so we could see whether there were any on which we could help?
Comment #23
catchhttp://api.scratch.drupal.org/ has support for classes, I couldn't find any issues blocking deployment via a quick search, but this looks like needs review to me.
Comment #24
jhodgdonWe need to talk to drumm and find out what the status of the rollout of the new code on api.drupal.org is.
Comment #25
catchhttp://api.drupal.org/api/drupal/classes/7
Actual issues should be opened against api module or infra, so this one can be marked fixed!