st 15. 4. 2020 v 17:43 odesÃlatel Isaac Morland <isaac.morl...@gmail.com> napsal:
> On Wed, 15 Apr 2020 at 11:26, Pierre Giraud <pierre.gir...@dalibo.com> > wrote: > > >> The best way to achieve this is to use some styling (font style and >> color). >> >> Attached you will find two different options I worked on very quickly. >> > > I really like the first. Just a couple of suggestions I would make: > yes, it is very well readable Pavel > - leave a space between the function name and (. Regardless of opinions on > what source code should look like, your documentation has space between > each parameter and the next one, and between the ) and the -> and the ->. > and the return type so it seems crowded not to have space between the > function name and the (. > - At this point it's not really a table any more; I would get rid of the > lines, maybe tweak the spacing, and possibly use <dl> <dt> <dd> (definition > list) rather than table-related HTML elements. See > https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dl. > > I think the bolding really makes stand out the crucial parts one needs to > find. > >
