I think my favorite documentation WTF had to do with product managers always including a boilerplate "must meet SLA" requirement, without knowing anything about the SLA.
The guidance document just says "Application Program Interface - An application programming interface (API) is a source code interface to support requests for services made by the computer program. An API specifies details of how two independent computer programs interact." as if I didn't know that bit already.
Beyond function signatures, of course, describe them. :)
Depending on the complexity, it could also be useful to provide guidance for using the API. I.e. a high level view to point people in the right direction.
Hmm. I would expect to see that in the document, but I don't know if I would want it in the API section. I think that the API section for the design you are documenting should be about its API.
Basically this web service acts as a thin bridge between a workflow and a component that I wrote outside of the scope of this project that's been mandated as a requirement to use by the people who awarded this project. Hopefully I'm being vague enough that I don't get myself into any trouble :P
I've recently uploaded the javadoc to the web, but it's an open source project, so it definitely doesn't have this mundane documentation. Actually like most open source projects the documentation is a bit lacking, but uh...hahah.
It goes something like Workflow -> WebService.doStuff(params) -> (make some Component API objects) -> Component.doStuff(apiStuff) -> Workflow.notify() (somehow)
@Sathya would you compare download speeds for http://sstatic.stackexchange.netdna-cdn.com/js/full.js and http://sstatic2.stackexchange.netdna-cdn.com/js/full.js for me?
I was wondering what kind of restrictions there are, if any, for code posted on StackOverflow?
In other words, I'm hoping StackOverflow has a clause that makes any posted code completely free of restrictions for reuse? (Both questions and answers).
This is a very ugly Chrome bug that causes the IFRAME that is the target for the image upload to immediately re-POST the previous request when it's added to the DOM.
I couldn't reliably reproduce it, until I found this very probably related Chrome bug report (it might also be related to these tw...
@balpha Ah, brilliant. Unfortunate that it required such an ugly hack, but at least there won't be 5000 duplicate images uploaded to imgur any more. :)
Also, I'll be damned that I never realized those were the repro steps...hahah.
How can i display an image instead of a text for a hyperlink? Please see my example, here you can see the text "x" and the background image. I want to show only the background image for the hyperlink.
http://jsfiddle.net/8rfyT/
I was wondering what kind of restrictions there are, if any, for code posted on StackOverflow?
In other words, I'm hoping StackOverflow has a clause that makes any posted code completely free of restrictions for reuse? (Both questions and answers).
Task: Print numbers from 1 to 1000 without using any loop or conditional statements. Don't just write the printf() or cout statement 1000 times.
How would you do that using C or C++?
This question has gathered 3 close votes. Would it be a better idea for a mod to lock and add the 'significant historical question' warning instead of closing it?
The pattern repeats every 1000 questions, so after 2000, 3000, ...
yes, no prizes for guessing the block size that some of our caching (for this screen) works at ;p
Good spot, thanks. I think this should now be fixed everywhere.
@Fosco - I have an appointment in 2 hours at the Apple Store. I suppose I should back up my source code now, but I want to spend the next hour coding. What to do?
@Fosco It's my summer project which I'm doing with my friend. For me the summer hasn't officially started yet. Also, my uncle wanted that app, although it seems he doesn't need it, I'm going to try and finish that up. It's nearly done.
@Manjot I understand that. Like I said, I haven't done that before, but I'd really recommend going through that site. I'm sure it answers at least most of your questions.
@tombull89 Perhaps he wants that to be a feature in his app, not the whole app.
Actually, @JeffAtwood, if you and @Spolsky are interested, I'm looking for a job, since I'm starting college in September. I'd love to work with you guys on an iOS client. (Thanks @Fosco for the idea.)
I recently created a bounty for a question on Stack Overflow
The bounty deadline came and went without a suitable answer (IMO). Because I wasn't happy with any of the answers I didn't accept any. Thus the bounty was awarded to the top answer.
I have no problem with the community awarding the bo...
Can anyone repro Area 51 being down for maintenance?
@Manjot No. I read in a BlackBerry development book at a local bookstore that RIM charges $200 per year for up to 10 apps. That was enough to convince me to put the book back. It also made me realize that Apple isn't so expensive after all.
Blackberry is a joke... the platform that only exists for the 'Enterprise'. A bullshit brand propped up by unfounded corporate, not consumer, interests.
> Remember... the the heat index is measured under shady conditions... and direct exposure to sunlight can increase the heat index as much as 15 degrees.
Hey @balpha, seeing as you're here and chat is your baby, are there plans to offer SEChat as a stand-alone product? Or are there any Open-Source clones?
I am looking for a Thumbnail / icon to place it on the left of my UITableViewCells. I will be adding a custom UITableViewCell and I can place it there. I would like to know if there some icons that area already created and uploaded in some website (that can be downloaded for free). Are there any ...