Wedge
Public area => The Pub => Off-topic => Topic started 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.
-
That's assuming people actually use/have an editor that supports it :P
-
A good amount of decent editors support it.
-
I don't use a fully fledged IDE, so the question is kind of moot for me.
-
I learned wordpress theming thanks to this tool from the Gods of Sillicon Valley... :P
-
I learned wordpress theming thanks to this tool from the Gods of Sillicon Valley... :P
Steve?
-
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.
-
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.
-
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
-
Yeah, I'm not so hot on that myself either :/
-
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.
-
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)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...
-
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.
-
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...
-
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.
-
Funny how this topic was about phpDocumentor :P
-
What's that? :P
-
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)
-
..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.
-
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.
-
Period comedy, eh? Might be an interesting watch, too...
-
It is, but be sure to watch it in order.
-
Why?
-
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.
-
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.
-
*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.)
-
If I'm writing new code, I document. If I'm modifying other people's code, I don't.