Small modification suggestion to new PHPDoc
| From: | Guilherme Blanco | Date: | Sat, 23 Aug 2008 17:13:17 +0000 |
| Subject: | Small modification suggestion to new PHPDoc | ||
| Groups: | php.webmaster | ||
| Request: | Send a blank email to php-webmaster+get-2510@lists.php.net to get a copy of this message | ||
Hi Bjori,
Pierre pointed me to message you.
I checked the new PHP Doc layout and I want to suggest 2 small modifications.
1- Code examples
They are too similar to documentation, so I suggest a way to
differenciate them from paragraphs.
The change is simple and could be tested with firebug before apply.
.example-contents {
background-color: #fff;
border: 1px solid #e2e2e2;
padding: 5px 10px;
}
This will modify all examples to have a white background with smooth
border color and internal padding to increase visual experience.
2- Differenciate sections
At the first glance, it's difficult to differenciate between section,
sub-section, etc.
Please try to find a combination of color/size/style that differenciates it.
If you prefer, I can give you a final patch to fix this too.
PS: I'm not subscribed to php-webmaster list. Please add me as
reply-to otherwise I'll not receive the message.
Thanks in advance,
Best regards,
--
Guilherme Blanco - Web Developer
CBC - Certified Bindows Consultant
Cell Phone: +55 (16) 9166-6902
MSN: guilhermeblanco@hotmail.com
URL: http://blog.bisna.com
Rio de Janeiro - RJ/Brazil