Comments can be helpful but just if we had a documentation with comments and without comments, like the PostgreSQL docs.
Also, some topics are better covered in cookbooks than in the book. On Wed, Jun 13, 2012 at 7:07 PM, Adam Monsen <[email protected]> wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > On 06/12/2012 12:46 PM, Bernhard Schussek wrote: > > IMO creating a PR there is a much better alternative to adding a > > comment > > +1. Doc comments seems like a handy feature of, say, php.net, but I > think something is horribly wrong when the information devs are > looking for is contained in comments on a documentation page rather > than in the documentation itself. > -----BEGIN PGP SIGNATURE----- > Version: GnuPG v1.4.11 (GNU/Linux) > > iQEcBAEBAgAGBQJP2Q8vAAoJEJtdmT+DbynAkZwIAJxty4oV7I0eXUJlSduGDaCu > 2rCcZd39WdEwirsCx3jOwmWB66Dp59afz3Gocs++N9GcDkU0UCrVzy9i1Blq423T > wd0PqicGj/QFdYu26uj7U6PdC8tABIuQgcMmdCfJRMYwMZRJ97voo1941KJfayhI > sDzLoU3uE4ZSE8gTjTdcqdaOVe9xl7jipuWAIlIpWlJhuONkwamh4ueNITnjO8at > cjKpbXxDtVXGo2/qM52uI4BPUfnHkJEEI7eulO+EC/LC/ocWwNCEjJH3hRooW9+/ > nIL7LE2/wjdPPatMQgga1fiYpWU7T/qn4y/1a3W227sjfLABHduaz17Auh1UV5A= > =P8XS > -----END PGP SIGNATURE----- > > -- > If you want to report a vulnerability issue on symfony, please send it to > security at symfony-project.com > > You received this message because you are subscribed to the Google > Groups "symfony developers" group. > To post to this group, send email to [email protected] > To unsubscribe from this group, send email to > [email protected] > For more options, visit this group at > http://groups.google.com/group/symfony-devs?hl=en > -- Blog: http://blog.eriksen.com.br Twitter: @eriksencosta -- If you want to report a vulnerability issue on symfony, please send it to security at symfony-project.com You received this message because you are subscribed to the Google Groups "symfony developers" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/symfony-devs?hl=en
