Timeline for Is it really worth to (implicitly) discourage documentation of API/library usage nowadays already?
Current License: CC BY-SA 2.5
13 events
| when toggle format | what | by | license | comment | |
|---|---|---|---|---|---|
| Aug 23, 2010 at 21:17 | comment | added | Sky Sanders | i aint mad atcha. actually most of those had c# and javascript. i don't code java or objective-c or ruby or assembly (any more) so i regret I could not provide a more balanced initial offering. perhaps i need a 'presenting common use cases and the guidance i can provide to solve them with an invitation to others to do same' throttle. ;-) | |
| Aug 23, 2010 at 21:12 | comment | added | jjnguy | @code, I know that everyone is welcome to participate. I was presenting my feelings at the time that most of the latest dev-tips were posted. | |
| Aug 23, 2010 at 19:09 | comment | added | Sky Sanders | And - regard whether this is an appropriate place to document common use cases. I think it is the perfect (only) place, in lieu of a better place, cough area51.stackexchange.com/proposals/10133/… cough to provide a clear discovery path to the available libraries and how to accomplish common use cases with same. | |
| Aug 23, 2010 at 18:44 | comment | added | Sky Sanders | @jjng - since our community discussion of the format of dev-tip there is no longer code in the question, only the use case. the answers are clearly marked with which library and which language the solution applies. Everyone is encouraged to present solutions to the common use case for any other platform. as to where I get the time: I have been a stay-at-home-dad for a year (which has come to an end) and I like to keep busy while I look for an interesting job with tolerable people. ;-) | |
| Aug 23, 2010 at 17:40 | comment | added | Steffen Opel | @jjnguy - sure thing, thanks much for your offer! Unfortunately I have once again prototyped for too long to get two smaller apps out already (am good at that ... ;) and been forced to commit to a full time freelancing gig meanwhile. The third and medium sized solution I'm most excited about actually (built with GAE, Jersey based REST interfaces and SW4J for the business logic) has been hold back due to the lack of dedicated API Terms of Service and resulting financing/staffing difficulties. | |
| Aug 23, 2010 at 15:37 | comment | added | jjnguy | @Steffen, good to hear that you are using SW4J. If you need any support, of have feedback for us, please shoot us an email. | |
| Aug 23, 2010 at 15:36 | comment | added | jjnguy | Re Doc: @Steffen It feels to me like his libraries are quite unique in their implementation, and thus don't translate to other libraries very easily. I guess, the main reason why I didn't have a problem with them being made CW was because I felt that the purpose of his posts was to boast about how awesome his libraries are. But, I can see their value, so I suppose discouraging (implicitly) them could be a determent to the community. | |
| Aug 23, 2010 at 15:33 | comment | added | jjnguy | Re C#: @Steffen No, I like the dev tips, but the most recent ones were only examples of C# code. I have no idea where he finds the time to work on SOAPI so much, but it was just overwhelming for me. I think in the long-run the dev-tips are great. But so many, in such quick succession was just too much. | |
| Aug 23, 2010 at 15:31 | comment | added | jjnguy | Re Mod: @Steffen, I can agree that Kevin may have acted too quickly. Decisions like that should be discussed before they are made. My guess is that Kevin didn't think his actions would be received so negatively. | |
| Aug 23, 2010 at 14:48 | comment | added | Steffen Opel | Re documentation: that is certainly something we could talk about and reach some sort of consensus eventually (i.e. I'm not opposed to this at all). However, the majority of the posts in question, no matter whether in C# or not, do provide guidance on how to deal with limitations and/or design artifacts of the API itself by implicitly exposing an appropriate algorithm, e.g. I've already translated code poets C# sample to Java two times already for use with your library, which I'm using for some prototypes incidentally ;) | |
| Aug 23, 2010 at 14:36 | comment | added | Steffen Opel | Re C# dominance: couldn't you just ignore those topics tags then? I certainly see your point and we would all benefit from a balanced representation of various client technologies, but do you think it is fair to introduce artificial throttles just because some users seem to be more active than others while still providing useful content? | |
| Aug 23, 2010 at 14:33 | comment | added | Steffen Opel | Re moderation: while I don't think that arbitrary moderator decisions are just fine, I'd certainly simply accept them as (unfortunate) facts of life and adjust my participation accordingly if this moderation 'policy' would have been stated upfront - however, constantly stressing the importance of and encouraging community discussions only to ignore it at personal discretion later on I do consider to be impolite at best ... | |
| Aug 23, 2010 at 13:16 | history | answered | jjnguy | CC BY-SA 2.5 |