Req #66861 [Opn]: Color sidebars <li>s for deprecation/new/...

Edit report at https://bugs.php.net/bug.php?id=66861&edit=1 ID: 66861 Updated by: bjori@php.net Reported by: eldmannen+php at gmail dot com Summary: Color sidebars <li>s for deprecation/new/... Status: Open Type: Feature/Change Request Package: Website problem PHP Version: Irrelevant Block user comment: N Private report: N New Comment: Didn't we at some point use <refsect1 role="soft-deprecation-notice"> ? http://git.php.net/?p=phd.git;a=commit;h=ed1d8c1f21d3a070b38275815453476741375626 We could add something similar, role="really-deprecated" and .. mh. Maybe we'd need to update the indexer then to so we can populate $toc properly.... This isn't something I have timefor anytime soon :/ Maybe its easier to inject this to versions.xml? but it'll still need to be added to $toc I think Previous Comments: ------------------------------------------------------------------------ [2015-01-06 18:11:46] aharvey@php.net That's the non-trivial bit. :) Bjori (and others), any thoughts? phd: namespaced attribute on the linked function. element? Additional attribute in the versions.xml entry for the function (eg <function name='foo' from='PHP 5' deprecated-in='PHP 7' />)? Something else? I think I'm leaning towards the versions.xml idea at first blush, but I don't know if we want to start overloading that sidecar file with extra metadata. ------------------------------------------------------------------------ [2015-01-06 16:39:59] cmbecker69 at gmx dot de It seems to me that it would be a good start if all deprecated functions would be marked with a respective CSS class. That would allow for some kind of highlighting (could be even done with a custom stylesheet), and easy sectioning via JS (better than nothing :)). ------------------------------------------------------------------------ [2015-01-06 16:17:11] bjori@php.net I think its an excellent idea. Might not be trivial to implement though ------------------------------------------------------------------------ [2015-01-03 14:53:47] eldmannen+php at gmail dot com Another mockup. Here we move all the deprecated functions into a separate section. http://i.imgur.com/EH1d9ew.png ------------------------------------------------------------------------ [2015-01-03 12:22:16] jacob@php.net I quite like the idea of showing deprecation warnings on old methods however I am not sure how this could be achieved design wise - would like to see some ideas or designs on approaches. :) ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at https://bugs.php.net/bug.php?id=66861 -- Edit this bug report at https://bugs.php.net/bug.php?id=66861&edit=1