Timeline for Is it really worth to (implicitly) discourage documentation of API/library usage nowadays already?
Current License: CC BY-SA 2.5
16 events
| when toggle format | what | by | license | comment | |
|---|---|---|---|---|---|
| Aug 25, 2010 at 22:33 | comment | added | Jonathan. | So due to this post (blog.stackoverflow.com/2009/05/a-theory-of-moderation) it says that SE sites are to meant to be pretty community run? Now it seems that its only Kevin who made this change, that's very community like isn't it? There's this huge fuss over a simple change that wasn't necessary. This site is different to other SE sites. The moderation here is kinda not important like it is on other SE sites, so it makes it feel like your left having to do more trivial tasks. | |
| Aug 24, 2010 at 2:05 | comment | added | Nathan Osman | ...and Jon Skeet could post spam if he wanted to anyway. | |
| Aug 23, 2010 at 20:24 | comment | added | Steffen Opel | @Kevin - you do not really want me to link or even quote all posts here again where I openly but politely (at least I think and hope so, else I apologize!) challenged your answer being somewhat off-topic at least (including this one) or didn't get any answer at all (incidentally including the very question which started all this, linked by @code just 2 comments above yours)? Do I really need to stress again that, had you only chosen to honestly answer the latter back then already instead of simply enforcing your POV by moderator power later on, we most likely wouldn't have this discussion now? | |
| Aug 23, 2010 at 19:46 | comment | added | Kevin Montrose | @code poet - ah, a personal attack with no examples, the highest form of internet debate. Do please, continue. | |
| Aug 23, 2010 at 19:31 | comment | added | Sky Sanders | And over the past few months I have noticed that you seem to have a terrific aptitude for avoiding direct questions and answering only on the vector that supports your position. Political tactics, intentional or not, add little to real conversations. We are trying to address a real (relatively speaking) issue upon which you seem to have formed an opinion and acted upon same unilaterally as if you are the community. A 'fair number of people' have noticed this and are not impressed. | |
| Aug 23, 2010 at 19:26 | comment | added | Sky Sanders | ok, so i was wrong about being blatantly targeted. But who is this 'fair number of people' show me.. stackapps.com/questions/1029/… . 'a fair number of people' is equivalent to 'some people say' which is an example of a classic fallacy that has gained much popularity lately. Which one I will leave as an exercise for the reader. | |
| Aug 23, 2010 at 19:20 | comment | added | Kevin Montrose | @code poet - stackapps.com/questions/tagged/dev-tip ; magically isn't it (note, a few were sufficiently borderline that they didn't get the CW'ing)? I would point out that this policy is not just my opinion, its the opinion of a fair number of people. Just doesn't seem to include you and Steffen; frankly, too bad. | |
| Aug 23, 2010 at 19:05 | comment | added | Sky Sanders | And you may forget that I can see your activity. You were not targeting 'dev-tips', you were specifically targeting my posts. What possible reason can you have to dig through my posts and CW How to call the API via JSONP in Plain Old JavaScript stackapps.com/questions/891, which was posted on Jun 25, at the very opening of the API to the public? Seriously dude. | |
| Aug 23, 2010 at 18:59 | comment | added | Sky Sanders | This is not SO. The community it serves is a relatively closed eco-system and as such have needs and interests that differ significantly than those of the SO community. If you show me an api or other software product that is only documented reactively I will show you a failure. Show me a library or api with minimal documentation of members with no common use cases or quick starts and I will show you a failure. Your insistence in imposing your opinions upon this community is doing it a disservice. | |
| Aug 23, 2010 at 18:31 | comment | added | Kevin Montrose | @Steffen - no [bug] posts have ever been CW'd. Only these [dev-tip]s. A history of useful contribution (which code poet does have) doesn't let you break the rules, Jon Skeet can't post spam on SO for instance. | |
| Aug 23, 2010 at 17:57 | comment | added | Steffen Opel | @Kevin - Excuse me? I think you are overreacting to the extreme and appear to take all this quite personally, thus pretty much failing on your moderation duties according to Jeffs Theory of Moderation. I urge you to reconsider: accusing the single most effective API contributor and bug hunter (apologies to all the other valuable contributors here), who is doing all this for free, for blatant rep-farming while gaining rep for solving those bugs you introduced yourself while getting paid is, bluntly, hypocrisy. | |
| Aug 23, 2010 at 17:22 | comment | added | Kevin Montrose | @Steffen - "poll style" means no correct answer, which the CW'd [dev-tip] posts definitely fell under. Bluntly, those posts were blatant rep-farming; because they weren't garbage, I CW'd them instead of deleting them since that seemed like an acceptable compromise (on any other site, they would have been deleted I'm quite sure; certainly after the 2nd one). I guess in the future I should just delete them since the rep is apparently all any cares about (as opposed to the post content, which was unaltered), and there can be no compromise there... | |
| Aug 23, 2010 at 10:43 | comment | added | Steffen Opel | Finally -1 for not answering my question. Thanks for responding to 1 out of 3 related questions at least, but I can't help but notice that you are not answering the question(s) at hand, rather try to get away with something else. If anything, your answer could have been a starting point regarding the acceptable moderation or reputation farming issues. However, here I stressed that whatever argument you might come up with, whether this would warrant discouraging welcome and useful posts, see update for more on this. | |
| Aug 23, 2010 at 9:16 | comment | added | Steffen Opel | Or to put it another way: please contemplate that this might simply be a type of question not existing before, just as Stack Apps is a type of site with noticeably different characteristics (unfortunately, but that's another topic). Of course these could be added to the library in question as well, but are you really suggesting that we should build a complete library handbook as answers to the one library post instead of providing easily discoverable use cases where solutions in the library of your choice might hopefully be deduced from others if absent? | |
| Aug 23, 2010 at 9:09 | comment | added | Steffen Opel | I tend to disagree, this is not a poll style question to me - I'm not a native speaker, but a poll asks for opinionated content regarding something (i.e. 'best', 'worst', 'funniest' etc.). This is an invitation to document API/library usage against a particular use case. Answering to one of these can take a considerable amount of time and respective software engineering effort, and no reader will be inclined to vote something up simply because he likes it most or prefers it over another, rather only if the example turns out to be useful guidance regarding the use case at hand. | |
| Aug 19, 2010 at 17:27 | history | answered | Kevin Montrose | CC BY-SA 2.5 |