« Anyone know Fancybox?
phpDocumentor
Flash is dead! »

Dragooon

  • I can code! Really!
  • polygon.com has to be one of the best sites I've seen recently.
  • Posts: 1,841
phpDocumentor
« on November 18th, 2011, 11:57 PM »
How many of you actively use phpDocumentor combined with full fledged IDEs? I've recently discovered it's usefulness especially with declaring parameter types/definitions and return types. By defining return type of another class I can easily follow chains without looking up the code actually.
The way it's meant to be

live627

  • Should five per cent appear too small / Be thankful I don't take it all / 'Cause I'm the taxman, yeah I'm the taxman
  • Posts: 1,670
Re: phpDocumentor
« Reply #1, on November 19th, 2011, 12:53 AM »
That's assuming people actually use/have an editor that supports it :P
A confident man keeps quiet.whereas a frightened man keeps talking, hiding his fear.

Dragooon

  • I can code! Really!
  • polygon.com has to be one of the best sites I've seen recently.
  • Posts: 1,841
Re: phpDocumentor
« Reply #2, on November 19th, 2011, 12:54 AM »
A good amount of decent editors support it.

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
Re: phpDocumentor
« Reply #3, on November 19th, 2011, 01:37 AM »
I don't use a fully fledged IDE, so the question is kind of moot for me.
When we unite against a common enemy that attacks our ethos, it nurtures group solidarity. Trolls are sensational, yes, but we keep everyone honest. | Game Memorial

DoctorMalboro

  • I like rounded borders.
  • Posts: 316
Re: phpDocumentor
« Reply #4, on November 19th, 2011, 01:47 AM »
I learned wordpress theming thanks to this tool from the Gods of Sillicon Valley... :P

Dismal Shadow

  • Madman in a Box
  • Me: Who is Arantor? Cleverbot: It stands for time and relative dimensions in space.
  • Posts: 1,185
“I will stand on my ground as an atheist until your god shows up...If my irreligious bothers you much, and if you think everything I do is heresy to your god I don't care. Heresy is for those who believe, I don't. So, it isn't heresy at all!


   Jack in, Wedge,
   EXECUTE!

Dragooon

  • I can code! Really!
  • polygon.com has to be one of the best sites I've seen recently.
  • Posts: 1,841
Re: phpDocumentor
« Reply #6, on November 19th, 2011, 07:57 AM »
Quote from Arantor on November 19th, 2011, 01:37 AM
I don't use a fully fledged IDE, so the question is kind of moot for me.
Actually the question was meant to be whether you fully document your code using phpDocumentor syntax or not.

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
Re: phpDocumentor
« Reply #7, on November 19th, 2011, 11:46 AM »
Wedge is partly documented, the rest of my own stuff, not so much - and with my own stuff it's because I don't use an IDE.

Nao

  • Dadman with a boy
  • Posts: 16,082
Re: phpDocumentor
« Reply #8, on November 19th, 2011, 01:16 PM »
I try to document any new function I add to Wedge, but basically it'll be down to whether or not it's already done in the same file... If it is, I'll just copy & paste some other function. Otherwise it'll be harder for me to start doing it :P

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
Re: phpDocumentor
« Reply #9, on November 19th, 2011, 04:54 PM »
Yeah, I'm not so hot on that myself either :/

Nao

  • Dadman with a boy
  • Posts: 16,082
Re: phpDocumentor
« Reply #10, on November 19th, 2011, 05:29 PM »
Why did we choose to fork such a huge project in the first place... :P

Alright, time to go watch an episode of QI. I don't know why... I just think it's time eheh.

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
Re: phpDocumentor
« Reply #11, on November 19th, 2011, 05:33 PM »
Quote
Why did we choose to fork such a huge project in the first place...
From what I remember, we did discuss forking other stuff or even building from scratch, but that we both knew the SMF codebase, didn't much like the other systems, and because you didn't want to build all the really dull stuff like user auth from scratch (can't say I blame you for that, though)
Quote
Alright, time to go watch an episode of QI. I don't know why... I just think it's time eheh.
Funny, I thought about doing the same, I rewatched half of DW season 4 last night, so maybe I could watch the only season of QI I have on DVD now...

Nao

  • Dadman with a boy
  • Posts: 16,082
Re: phpDocumentor
« Reply #12, on November 19th, 2011, 06:21 PM »
It was a rhetorical question, though :P

As for QI... Ended up watching a French quiz show that was on TV, instead. Meh, it sucked. At least QI doesn't offer silly prizes or anything. People are just there for the fun of it, not to win... It's like a family game night, where you learn stuff.
I'm halfway into season 1, and also watched the Tennant and Radcliffe episodes (seasons 7 and 8). The Radcliffe one was pretty great, I'm impressed the show manages to be funny even 8 seasons into it.

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
Re: phpDocumentor
« Reply #13, on November 19th, 2011, 06:24 PM »
Quote
People are just there for the fun of it, not to win... It's like a family game night, where you learn stuff.
That's the joy of it, they're there to be amused/amusing, not for prizes - most of them don't need anything in the way of prizes as most of them are already gainfully employed in the various celebrity professions anyway. Radcliffe for example really doesn't need the money.

The real reason it stays funny is because Fry and Davies are very good comedians and play off each other brilliantly, and because it's an ever changing mix of people, there's always a mix of imagination and humour to work with. I sometimes wonder if they had a drink before starting the show, too...

Nao

  • Dadman with a boy
  • Posts: 16,082
Re: phpDocumentor
« Reply #14, on November 19th, 2011, 11:06 PM »
They certainly did.
So far the guys I didn't know and have fallen for are Davies, Jupiter and Lee Mack. They're hilarious. Also Fry is much more lovable compared to his stints in Blackadder.
« Anyone know Fancybox?
Flash is dead! »