Closed (fixed)
Project:
Drupal core
Version:
8.0.x-dev
Component:
documentation
Priority:
Normal
Category:
Task
Assigned:
Unassigned
Reporter:
Created:
15 Sep 2012 at 04:01 UTC
Updated:
5 Jan 2016 at 20:34 UTC
Jump to comment: Most recent
Comments
Comment #1
webchickCreated a node for this at http://drupal.org/node/1785368
Comment #2
catchPostponed issues are counted in thresholds now, and there's only a couple of variables left.
This feels like a 'nice to have' to me so downgrading from major.
Comment #3
jhodgdonI think it might be useful for someone to put some explanation into this change notice node as to what it means and how to use it.
Comment #4
catchMeant to move this to active.
Comment #5
catchhttps://api.drupal.org/api/drupal/core%21includes%21update.inc/function/... has all the changes - I also wonder whether that + an explanation might be enough.
Comment #6
jhodgdonI have just edited https://drupal.org/node/1785368 as a first pass at doing what is suggested in comment #5. Should we leave it at that? I am inclined to agree with catch that building and maintaining a list of all the variables may not be necessary and it's also definitely a lot of work (though perhaps a good Novice project, now that this explanation is right there on how to do it)?
Comment #7
jhodgdonBump. I think maybe this is done? Tentatively marking RTBC to attract attention. I'll mark it fixed if no one objects in the next few days.
Comment #8
webchickAgree with the priority downgrade.
And, hm. That's definitely not ideal, since it requires hand-clicking on up to (currently) 46 functions in order to hopefully land on one that changes the out-dated variable in question that you have in your install profile so you know what it switched to.
In such a situation, what you want to search for is a string like 'site_frontpage'. But you'll get no results found on https://api.drupal.org/. You will find it if you click on https://api.drupal.org/api/drupal/core!modules!system!system.install/fun..., but I'm not sure how an average person would've arbitrarily found that in that gigantic list.
Incidentally, this variable in particular has a dedicated change notice at https://drupal.org/node/1668806 already, so it will come up in searches on change notices for "site_frontpage". Maybe the true way to resolve this is just to create similar dedicated change notices for "frequently accessed variables" like that. I agree one massive table with all of them is unlikely to ever get done.
Comment #9
jhodgdonAgreed with it being good to be able to search change notices to find the variable names.
Currently, the best/only way for someone to search for these would be to download 8.x and use grep, and IDE, or another method to search the code base. I have added that to the instructions in case people don't think of that; you're right, api.drupal.org won't help in this regard.
I'm not sure which variables would qualify as "frequently accessed" to think of which should be added here.
Comment #10
jhedstromWhat's left to be done here?
Comment #11
jhodgdonPersonally I do not think it is reasonable to expect a complete list of variables to be on that page and I am in favor of marking this issue as fixed.
Comment #12
jhodgdonI am just going to mark this very old issue as fixed at this point. I don't think we can/should do more.