Monday, December 05, 2005

Wanted: Lxr + DokuWiki + Google Desktop Search

I want a plugin for GDS that indexes and cross references PHP code - it should work like Zend's control+click to load a class, but it should be fast and easy to search.

It should also tie directly into documentation if it exists.

I'm sick of have a funky method added to a class by a codeveloper in an effort to increase the size of a big ball of mud, only to be unable to deprecate it properly because I don't know what it will break.

5 comments:

Anonymous said...

You seem to have lost some of your customary clarity Dan - we didn't understand that last sentence at all

We are used to you being esoteric and elitist but this is too much


Have we had too much xmas cheer or.... ?

Dan said...

Full rant explaining mode is now ON.

Big Ball Of Mud: code that has two different implementations of the Kitchen Sink, a carport, a baby cradle, and airbags built into it...

...when it's meant to be a can opener.

Codeveloper: Someone you work with, but actually often work against.

Deprecating: You use a @deprecated in your documentation and then hit people with a stick if they use that bit of code anymore. You can't delete the code outright, because it might break things. See below.

Funky method: It's a third kitchen sink, welded to a fridge. If you try to take out the third kitchen sink, your fridge doors fall off at the same time, which isn't good, because you don't know until all of your food has spoiled, you've eaten it, and died of some ghastly disease.

A plugin for GDS like I describe would be a quick and dirty, easy to navigate, built-from-documentation view of all of the source code in your project. All cross referenced; you can see what this is kind of like on the Mozilla LXR.

With something like that, I could find out who to blame, how much to blame them, and what I have to do to fix it next time someone adds "a cool feature" to my code.

Anonymous said...

Why thank you, consider us educated now! And such prompt service too :)

We had assumed the new editorial restrictions on comments were directed against us, but presumably not.

In the interests of your normal, more geeky audience:
/full rant mode OFF

Dan said...

I had my hopes up: 13 WHOLE COMMENTS NEW COMMENTS IN MY INBOX!

... which turned to queasyness a short time later: 13 whole advertisments for fitness viagra gym or somesuch.

Anonymous said...

LOL

Perhaps true genius isn't appreciated in its own time, 1.3 comments seems closer to your average :(

If you aren't getting sufficient reaction to your intellectual rants at least you can console yourself with the masses of people drooling over you at hotornot