18

My team recently released a product that has a public api. We provided several api clients, but we want to encourage users to write their own as well.

It is against SO community guidelines to ask a specific question about implementing an api for my product with my own answer?

It would certainly be helpful to anyone looking to consume the api, but I can't deny that I'm also looking to draw new users to use my product.

According to this question, many would say this is NOT ok. However, I'm clearly active on SO for much more than self promotion.

Update

I still believe this is not a duplicate because I plan on asking good, specific (but not too specific questions) like a good stack overflow user. However, what is starting to make sense to me from everyone's answer and comments, is that I should either wait for my users to post questions, or wait until I've been asked the same question multiple times and self-answer it. We have good documentation, and it's getting better, but some people just google stack overflow.

12
  • 1
    just be careful to ensure it doesn't fit any of the close reasons. to me it sounds borderline too broad
    – Kevin B
    Commented Jan 18, 2016 at 21:20
  • @KevinB borderline? Sounds pretty far past the border to me.
    – Servy
    Commented Jan 18, 2016 at 21:20
  • I would agree my example question is far too broad. Perhaps something more like "How do I post a message to the api/Log service with javascript?" would be better.
    – jrummell
    Commented Jan 18, 2016 at 21:23
  • Specific use cases scoped within the bandwidth of a question/answer and you might be OK. I'd stay away from some languages, tho (c++, PHP)
    – user1228
    Commented Jan 18, 2016 at 21:29
  • I don't see "How do i do X" as being "Too Broad" unless "X" can be a complete application or module on it's own. hence why i said borderline. In this case, it seems like mentioning the product at all would be unnecessary for a question like this, making it a bad fit for what the op is trying to do.
    – Kevin B
    Commented Jan 18, 2016 at 22:07
  • @Will Just curious, what was the reason for avoiding certain languages like c++ and php?
    – Dan
    Commented Jan 19, 2016 at 1:59
  • Yes, I know my original example question was too broad. But that wasn't the point of my inquiry.
    – jrummell
    Commented Jan 19, 2016 at 2:12
  • 2
    It sounds like what you really want to do is write documentation. SO is great, but to some extent having to look here means the API developer has already failed.
    – Kristján
    Commented Jan 19, 2016 at 4:29
  • 1
    The nominated duplicate IMHO fails to address this question; it is specifically about somebody posting multiple near-duplicates.
    – tripleee
    Commented Jan 19, 2016 at 6:52
  • 2
    @dan because they are bitter and angry and will downvote anything because their hearts have turned into black lumps of coal due to the horrible languages they code in every day. And they coordinate dvs and cvs because of the torrent of trash washing over their tags day in and day out.
    – user1228
    Commented Jan 19, 2016 at 13:46
  • @Will Thats what I thought haha
    – Dan
    Commented Jan 19, 2016 at 19:40
  • 1
    Check deduplicator's comment on the answer - writing good question to be self-answered is ridiculously hard (especially if you have semi-decent documentation indexed by search engine). Getting -5 for "not even tried to search" not going to make your "seeding" any better. You may get better return on your time by cleaning up questions asked by actual users. Commented Jan 20, 2016 at 3:46

1 Answer 1

18

"How do I consume my product's API with language X?" with my own answer?

Such a question would unquestionably be Too Broad.

That said, if you can ask appropriate questions, then this is acceptable, but you need to disclose your affiliation with the product when posting about it.

4
  • 1
    Thank you. This was my understanding, but I wanted to make sure I wasn't off base.
    – jrummell
    Commented Jan 18, 2016 at 21:24
  • 9
    @BenVoigt already pointed this out (indirectly) above, but from here it states: "There has to be some existing questions about your product on the site, preferably tags specific to your product to accompany them. It's generally best if these come from our community, we advise against seeding the site with questions about your product. " (Italics added) Commented Jan 19, 2016 at 1:52
  • 2
    @jrummell: Wishing you success, but I want to stress that writing a good question is often not easy, writing a good self-answered question is quite hard, and if you write it about your own thing, it's really hard. The recommendation for the latter is letting them be asked here organically... Commented Jan 19, 2016 at 7:41
  • @Deduplicator that's a good point.
    – jrummell
    Commented Jan 20, 2016 at 14:08

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