Proposal: add strikethrough effect to removed functions and gray out deprecated functions in function lists

From: Date: Tue, 12 Nov 2013 14:49:29 +0000
Subject: Proposal: add strikethrough effect to removed functions and gray out deprecated functions in function lists
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969384722@lists.php.net to get a copy of this message
Hello all, Currently, contents pages with lists of functions, and the sidebars on function pages, do not show you whether a function is removed or deprecated. In fact, if a function is removed, it is simply left there in the list as if nothing had changed. So, I propose two small visual tweaks. If a function has been removed, it has a strike-through effect on its name. If a function has been deprecated, its name is in gray. If a function is both removed and deprecated, it is both. The effect would be purely cosmetic, and not prevent you clicking through to see the documentation. This would look something like this: http://i.imgur.com/NLFu9Zg.png (I used Firefox's inspector to change the CSS for those three functions, and the page was zend_logo_guid, hence it is bolded. Those functions are actually deprecated/removed.) Of course, this styles doesn't have to be a strike-through or a gray-coloured link, that's just my suggestion. Thoughts? -- Andrea Faulds http://ajf.me/

« previous php.doc (#969384722) next »