Phalcon 2 Docs - "Methods" are hard to read

I'd like to say thank you for all the time and effort that has gone into this great project.

I use the phalcon documentation just about every day whether I'm developing myself or helping others. One thing that was mentioned in the IRC chat was that with the new docs update, the "Methods" section of any component is difficult to read. There isn't really any distinction between the method signature and the method description.

I was playing around with the dev console in chrome and came up with the following as a suggestion:

Styles:

.method-definition {
  background: none repeat scroll 0% 0% #F2F2F2;
}
.method-definition > p.method-desc {
  color: #4070a0;
}

Updated html:

<blockquote class="method-definition">
  <p class="method-signature">
    <span class="modifier">public</span> <em>boolean</em>  <strong>validate</strong> (<em>unknown</em> $validation, <em>unknown</em> $field)
  </p>
  <p class="method-desc">Executes the validation</p>
</blockquote>

Result:

http://s18.postimg.org/xe41ygt6x/phalcon_Docs.jpg

Full Size: http://s16.postimg.org/yxpwv1fz8/phalcon_Docs.jpg



1.2k

completely agree!..please make a pull request, they will definitely accept it =)