Wedge

Public area => The Pub => Off-topic => Topic started by: Dragooon on November 18th, 2011, 11:57 PM

Title: phpDocumentor
Post by: Dragooon 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.
Title: Re: phpDocumentor
Post by: live627 on November 19th, 2011, 12:53 AM
That's assuming people actually use/have an editor that supports it :P
Title: Re: phpDocumentor
Post by: Dragooon on November 19th, 2011, 12:54 AM
A good amount of decent editors support it.
Title: Re: phpDocumentor
Post by: 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.
Title: Re: phpDocumentor
Post by: DoctorMalboro on November 19th, 2011, 01:47 AM
I learned wordpress theming thanks to this tool from the Gods of Sillicon Valley... :P
Title: Re: phpDocumentor
Post by: Dismal Shadow on November 19th, 2011, 01:47 AM
Quote from DoctorMalboro on November 19th, 2011, 01:47 AM
I learned wordpress theming thanks to this tool from the Gods of Sillicon Valley... :P
Steve?
Title: Re: phpDocumentor
Post by: Dragooon 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.
Title: Re: phpDocumentor
Post by: Arantor 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.
Title: Re: phpDocumentor
Post by: Nao 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
Title: Re: phpDocumentor
Post by: Arantor on November 19th, 2011, 04:54 PM
Yeah, I'm not so hot on that myself either :/
Title: Re: phpDocumentor
Post by: Nao 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.
Title: Re: phpDocumentor
Post by: Arantor 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...
Title: Re: phpDocumentor
Post by: Nao 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.
Title: Re: phpDocumentor
Post by: Arantor 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...
Title: Re: phpDocumentor
Post by: Nao 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.
Title: Re: phpDocumentor
Post by: Dragooon on November 19th, 2011, 11:23 PM
Funny how this topic was about phpDocumentor :P
Title: Re: phpDocumentor
Post by: Nao on November 19th, 2011, 11:24 PM
What's that? :P
Title: Re: phpDocumentor
Post by: Arantor on November 19th, 2011, 11:53 PM
Fry is supposed to be an obnoxious character in Blackadder, just as he is the consummate professional valet in Jeeves and Wooster (alongside Hugh Laurie as Wooster)
Title: Re: phpDocumentor
Post by: Nao on November 20th, 2011, 12:27 AM
..which I've never heard about ;)

My recent memories of Fry are pretty much Blackadder, Reaver in Fable III (a cool bad guy), and the narrator in H2G2. Sigh.
Title: Re: phpDocumentor
Post by: Arantor on November 20th, 2011, 12:29 AM
Jeeves and Wooster is a good adaptation of the P.G. Wodehouse tales, of the valet who inspired Ask.com. Worth a watch but it is period drama set in the 1920s or so.
Title: Re: phpDocumentor
Post by: Nao on November 20th, 2011, 12:32 AM
Period comedy, eh? Might be an interesting watch, too...
Title: Re: phpDocumentor
Post by: Arantor on November 20th, 2011, 12:34 AM
It is, but be sure to watch it in order.
Title: Re: phpDocumentor
Post by: Nao on November 20th, 2011, 12:35 AM
Why?
Title: Re: phpDocumentor
Post by: Arantor on November 20th, 2011, 12:37 AM
Because events happen earlier on that are related to later, such as the people Bertie Wooster has the misfortune to become engaged to, as well as the engagements of others.
Title: Re: phpDocumentor
Post by: Nao on November 20th, 2011, 10:52 PM
Watched the first episode... It had its moments, but was a bit on the slow side.
Felt much like a Poirot episode, but without a murder.
Title: Re: phpDocumentor
Post by: Arantor on November 21st, 2011, 12:27 AM
*nods* It certainly has the Poirot age and feel, but I can understand the slow feeling. (I don't remember the first episode being slow though.)
Title: Re: phpDocumentor
Post by: PantsManUK on November 21st, 2011, 11:46 AM
If I'm writing new code, I document. If I'm modifying other people's code, I don't.