10

I have a question regarding how to interpret / invoke a method found in Apples Swift Developer documentation.

Can I ask a question regarding a programming languages documentation on Stack Overflow?

11
  • I've asked my question here: stackoverflow.com/questions/30226888/… May 13, 2015 at 23:39
  • I've left a comment on your linked post. The question (as you actually posted it) IMO is not appropriate for SO, because it's far too vague. My comment (to your SO post) explains why.
    – Ken White
    May 14, 2015 at 0:09
  • @KenWhite I disagree. Unless there is no rhyme or reason to documentation at all, there has to be a methodical process to finding what you need and seeing what it takes to invoke it. May 14, 2015 at 0:15
  • There certainly is - it's specified in the documentation, as are the standards used for that documentation. If you can't read it there, why would you be able to read it at SO? The methodical process is read the documentation, including the standards that are followed (and explained) in it, and then look at examples if the documentation isn't clear to see how it's done.
    – Ken White
    May 14, 2015 at 0:22
  • 1
    You might have some luck at Ask Different, but I'm not 100% sure if it would be on-topic. From the help center: Code-level programming questions (cocoa, LLVM, etc…) are off-topic here, however we do allow AppleScript, Automator, and UNIX shell scripting questions like "How to use homebrew"
    – Zizouz212
    May 14, 2015 at 2:29
  • 1
    How terrible are the Swift docs? I'm sure they're covered under fifteen layers of NDA bullshit, but if you added an example to your question taken directly from these docs perhaps someone can pull it apart and demonstrate how it applies to actual code? If you're actually afraid of Apple's stupid NDAs, you could rewrite a document for a method to make it nonsensical. They can't possibly be NDA-ing the format of their documents as well as the contents, right?
    – user1228
    May 14, 2015 at 14:00
  • That was my initial thought @Will. I did add an example in my original question. I think it confused people and they just tried showing me working examples of the method without explaining how they arrived at it... so I removed the example. May 14, 2015 at 14:04
  • Did you post an example from the docs then show your (incorrect) interpretation? That way people could possibly see where your disconnect is. Describing your thought process on the interpretation would be advisable as well.
    – user1228
    May 14, 2015 at 14:06
  • I showed my attempt, perhaps I shouldve explained my thought processes more. Either way, I completely understand why the question was confusing and why it got put on hold. I think i just need to spend more time in the docs and that's all there is to it. No silver bullet answer. May 14, 2015 at 14:10
  • The rabidity of SO members regarding Apple's NDAs is obscuring your view, @Will. The docs are freely available for your copy-pasting pleasure.
    – jscs
    May 14, 2015 at 19:10
  • 2
    @JoshCaswell I'm informing Apple you've violated your NDA. Some NDA, at least. NDA ALL THE THINGS!
    – user1228
    May 14, 2015 at 19:44

1 Answer 1

15

Such questions would be on-topic. So yes, you can ask them.

Be very clear on what part of the documentation you don't understand and show your research, as these kind of questions can easily be construed as having a lack of effort. Otherwise, go ahead!

1
  • 1
    Thanks Bradly, my post is ready to submit but after reading your answer. Maybe I'll make another attempt at understanding the documents. May 13, 2015 at 23:16

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .