[wp-hackers] Inline Documentation Effort was a Failure

Jorge Peña jorgepblank at gmail.com
Thu May 22 22:14:36 GMT 2008


Otto said:
I've recently starting using the Eclipse PDT for editing and creating
PHP projects, and find that use of full out IDEs like this makes it
not only much easier to add inline documentation, but it gives you a
valid reason to do so as well. When looking at code, having the
ability to simply put the cursor over a function call and see that
documentation pop up in a biggish tooltip is extremely handy and kind
of makes you want to document your own functions correctly.

is this feature available in Zend Studio? I would imagine so, but I'm not
positive.

On Thu, May 22, 2008 at 10:03 AM, Peter Westwood <peter.westwood at ftwr.co.uk>
wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Otto wrote:
> | On Wed, May 21, 2008 at 10:41 PM, Jacob Santos
> <wordpress at santosj.name> wrote:
> |> Reasons The Effort Failed (in my humble opinion):
> |> ...
> |> 3. You can't have majority of the core developers not adding inline
> |> documentation.
> |
> | I believe this might be because many of the core developers do not use
> | a full fledged IDE for developing PHP code. This is just a guess on my
> | part, but a lot of the people I know who edit PHP use editors that are
> | essentially little more than text editors with syntax coloring.
> |
> [snip]
> |
> | Perhaps if the devs try using some of these sort of IDEs, some
> | progress can be made on this front? Having Eclipse PDT with the
> | Subclipse plugin to pull directly from the SVN is extremely handy and
> | neat to play with.
>
> Depending on where I am / what mood I am in / the type of patch being
> reviewed / the system to test on I do already use PDT with Subsclipe and
> XAMPP for development work.
>
> However for some of the patch review process command line editors and
> tools are much much more efficient.
>
> westi
> - --
> Peter Westwood
> http://blog.ftwr.co.uk | http://westi.wordpress.com
> ~ C53C F8FC 8796 8508 88D6 C950 54F4 5DCD A834 01C5
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.7 (MingW32)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFINadhVPRdzag0AcURAjjbAKDC6giVHlvHC4UcGkfCUYtjbkiM1ACeJsU/
> 8LKa+dz7hVz+Q9J2MVvIj0g=
> =TT83
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> wp-hackers mailing list
> wp-hackers at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-hackers
>


More information about the wp-hackers mailing list