|
The tool you describe can ensure that a comment exists; it can't ensure that the comment is current. I suppose that a slightly more sophisticated tool could ensure that comments are modified along with functions, but that is not always necessary (e.g. fixing a bug would not necessarily change the description of a function).
Until this problem is solved, any fancy tools that e.g. link a function to the requirement that was responsible for it are worse than useless.
If you have an important point to make, don't try to be subtle or clever. Use a pile driver. Hit the point once. Then come back and hit it again. Then hit it a third time - a tremendous whack.
--Winston Churchill
|
|
|
|
|
Something like this[^], or this[^]?
"These people looked deep within my soul and assigned me a number based on the order in which I joined."
- Homer
|
|
|
|
|
Exactly. Just tried and googled and none of them is working... unfortunately.
|
|
|
|
|
Heck, I want a 3 dimensional code editor. You have an if statement? The code branches orthogonally to the main code "vector". If-else? Same idea, but with two orthogonal branches. nested loops? Again, you can render that in 3D rather than a 2D "one inside the other" surface.
It would really be quite fascinating to see code represented three dimensionally and be able to fly around it, zoom in/out, etc.
Marc
|
|
|
|
|
How would recursive functions be handled?
|
|
|
|
|
5 seconds after you attach an image to a line of code, the requirements change, and the image/doc/whatever is now useless.
I worked on a project where we all had the spec printed out on our desk. It was 3" thick - and VERY outdated. We spent more time discussing what the spec really meant than coding it.
Any spec is outdated the moment it's saved. Now imagine that attached to ever changing code. Mass confusion ensues.
Terrible idea.
If it's not broken, fix it until it is
modified 29-May-15 10:17am.
|
|
|
|
|
My first thought is if you need a picture to explain what is going on, it might be time to refactor and simplify.
|
|
|
|
|
There is already an extension that does that (and a bit more...)
Look for MarkdownComments in the tools/Entensions and update menu.
|
|
|
|
|
Movie Quote Of The Day
Deoxyribonucleic acid!
Which movie?
|
|
|
|
|
/pedant : isn't an 's' missing here ?
/edit: Ah, betrayed by my French ("acide désoxyribonucléique") : no 's' in English ... Interesting, but seems logic when you think about it.
Anyway, "Jurassic park ?"
|
|
|
|
|
Habemus T-Rex!
The language is JavaScript. that of Mordor, which I will not utter here
This is Javascript. If you put big wheels and a racing stripe on a golf cart, it's still a f***ing golf cart.
"I don't know, extraterrestrial?"
"You mean like from space?"
"No, from Canada."
If software development were a circus, we would all be the clowns.
|
|
|
|
|
|
Russell Brand's Big Night of Science!?
veni bibi saltavi
|
|
|
|
|
V. wrote: acid!
How am I supposed to tell? Aren't all actors on that??? 
Anything that is unrelated to elephants is irrelephant
Anonymous
-
The problem with quotes on the internet is that you can never tell if they're genuine
Winston Churchill, 1944
-
I'd just like a chance to prove that money can't make me happy.
Me, all the time
modified 29-May-15 6:18am.
|
|
|
|
|
Cheech & Chong - the comedown
Every day, thousands of innocent plants are killed by vegetarians.
Help end the violence EAT BACON
|
|
|
|
|
I told my mate I had reverse engineered DNA, but he wasn't very enthused by the news.
He just said "And?".
Some men are born mediocre, some men achieve mediocrity, and some men have mediocrity thrust upon them.
|
|
|
|
|
Could you repeat that? the movie
Life's like a nose, you've got to get out of it whats in it!
|
|
|
|
|
Chemicalogy 
|
|
|
|
|
|
It's probably Farcebook themselves doing that, the stockholders demand return on their investment.
Check the EULA for a chilling experience, they're fully allowed to do that.
|
|
|
|
|
I think the first error here was to start using farcebook.
|
|
|
|
|
Most probably it was done by an app which had permission to post on the DEAD friend's behalf. 
|
|
|
|
|
Surely, even apps have to login to FB to post something?
Anything that is unrelated to elephants is irrelephant
Anonymous
-
The problem with quotes on the internet is that you can never tell if they're genuine
Winston Churchill, 1944
-
I'd just like a chance to prove that money can't make me happy.
Me, all the time
|
|
|
|
|
If the app knows the username and password (which most do) they can log in without user interaction.
What do you get when you cross a joke with a rhetorical question?
The metaphorical solid rear-end expulsions have impacted the metaphorical motorized bladed rotating air movement mechanism.
Do questions with multiple question marks annoy you???
|
|
|
|
|
True. That would of course mean that it was an app the user had installed himself. And not only that: An app from a company with highly questionable moral standards... 
Anything that is unrelated to elephants is irrelephant
Anonymous
-
The problem with quotes on the internet is that you can never tell if they're genuine
Winston Churchill, 1944
-
I'd just like a chance to prove that money can't make me happy.
Me, all the time
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
