Stack Overflow - Documentation

Wow, catches the plague and still writes articles. I’m impressed. :mask:

Yeah! I was in Vegas last week to accompany my wife who was presenting at a conference, and I managed to catch something in the airport on the way there itself. Still not fully recovered yet :doughnut:

1 Like

I just answered a question on SO this morning and got Privileges > Documentation Votes!

1 Like

Nice! I’m sure that “privilege” will be a source of joy and rewards for many years to come.

1 Like

Yeah, still need to figure out what this Documentation thing is about…

I wonder why that would be since Documentation has been shutdown and removed? Tagging posts for future iterations perhaps?

I thought “what you catch in Vegas stays in Vegas” or am I remembering that tv commercial wrong

I’m assuming its part of the Documentation integration they have yet to remove, or simply forgot existed.

Yeah perhaps.

Unless they purposely kept it enabled to grab references for a future endeavor. I know they said something will eventually come out of the documentation experiment in the sunsetting announcement referenced above.

With your wide ranging knowledge and ability to effortlessly articulate yourself technically in understandable form, you would certainly be a wonderful contributor. Or perhaps you could foster and share those skills through other channels such as guest articles on sites, a book, blog, etc., if you would desire. Same goes for @krilnon, and of course @kirupa with all he does already.

Certainly not as fun as collecting plastic characters, but almost as worthy of a cause. :thinking:

Tourism would probably increase exponentially if that was the case, however I think as of now what you catch is considered your free parting gift for visiting. :pimp:

Except for all them Pokemon Go players!

2 Likes
1 Like

I work with Erika (and the other documentation team people!) I need to go and get my autograph book and get them all to sign it. I’m glad that everyone (Google as well) is collaborating on this. The fragmentation and duplicated API content was always painful to see :stuck_out_tongue:

Interesting stuff.

Good to see all the people that are making a difference with innovation ( Microsoft / Samsung / Google ) participating. Given that, I guess it’s only fitting Apple is not involved. Maybe when a button needs removed they will participate? :eyes:

I wonder why the article @kirupa posted mentioned Vivaldi but not Blisk, since its geared more for developers. Speaking of which Firefox Developer Edition / Tools are looking pretty nice now days.

Ok - I posted the first of the articles here: https://www.kirupa.com/html5/arrow_functions.htm The attribution information is the first thing before the main content shows up. It is a bit clunky going through the JSON file, getting the relevant details, and converting them into regular HTML. I wish this were something done better by the SO team.

I am not sharing this broadly just yet. I want you all to take a look at it and see if this works. One of the things I need to call out is that this information is designed to be more in the snippet-form of documentation as opposed to the “story-like” form that most of the articles here take.

:slight_smile:

Meh, that information isn’t any better than “official” documentation on mdn, and not as clear and in some ways misleading. Not sure its worth trying to port over web documentation like that if there’s already a better alternative. Not sure what else SO docs has that would be (I never knew about it until this thread)

1 Like

One main advantage is that it does allow gaps in content to be filled. But if the quality is low and confusing, then moving forward with it doesn’t make sense. For example, another topic I was considering was this one around Promises.

If this makes sense to move forward with other SO articles, these would all be in a section that I am tentatively calling TL;DR. That sets the expectation that it is a quick reference.

Is that how it would work here? I was assuming this would be more of a dump than a collaborative surface.

The Promises example starts off …promising… :trout: but then starts to …flounder… :trout: :trout: quickly after that.

The multiple posts reminds me of PHP documentation where there’s a lot of good information, but its scattered throughout a myriad of comments which can be hard to parse.

2 Likes

That settles it, then! The SO documentation will not migrate over. There is no reason to confuse web developers with low-quality content :stuck_out_tongue: