eWorld.UI - Matt Hawley

Ramblings of Matt

When GhostDoc Fails...

March 22, 2005 18:20 by matthaw

Since pictures are worth a thousand words…

AlreadyScheduled

As you can see, GhostDoc isn’t 100% accurate on creating decent documentation.

Update – here’s a better one that really makes me chuckle…

ToString


Be the first to rate this post

  • Currently 0/5 Stars.
  • 1
  • 2
  • 3
  • 4
  • 5

Categories:
Actions: E-mail | Permalink | Comments (5) | Comment RSSRSS comment feed

Comments

March 22. 2005 19:27

You should send this over to www.TheDailyWTF.com Smile

Derick Bailey

March 22. 2005 19:29

Nah, not funny enough. Just enough for a chuckle.

Matt Hawley

March 22. 2005 21:52

In fact, "Toes the string" is a running gag with the guys at work Wink



Very common methods like "ToString()" or "Equals()" will be handled in a more intelligent way in a future version.



Regarding "AlreadyScheduled": This is a case where a rule *would* be possible, but a different naming of the method could even be better; I'd call it "IsAlreadyScheduled()". One advantage: If you have several methods that check a state, you'll find them all in one place when using intellisense. Another advantage: GhostDoc knows how to handle methods starting with "Is..." or "Has..." Wink



Roland

Roland Weigelt

March 22. 2005 21:54

Thanks Roland, I figured I could have made the architecure better, but I'm just documenting and don't want to change the code base.



Good to see "Toes the string" is a gag for you as well Smile

Matt Hawley

March 30. 2005 21:56

My favorite is still "Ons the Init". I spend a lot of time oning my init.

Scott

Add comment


 

  Country flag

[b][/b] - [i][/i] - [u][/u]- [quote][/quote]



Live preview

September 6. 2008 15:39



Copyright © 2000 - 2008 , Excentrics World