121–130 of 136 posts
It would be nice if there is SO for business. Lots of companies have terrible internal documentation, Q/A tools.
Odoo Q&A is an open source clone of stackoverflow: https://www.odoo.com/page/community-builder It has three mode: forum, Q&A (clone of SO), share links (like HN)
What I'm most worried about is the duplication between the canonical documentation of a project and the StackOverflow one. As the author of an open-source project, I try my best to write a great documentation, and I would be a bit annoyed if people started to add examples to StackOverflow just to gain reputation there instead of contributing to the "official" one. Also, SO is ranked way higher than the smaller-projec…
- [Upstreaming content on Stack Overflow Documentation - Meta Stack Overflow](http://meta.stackoverflow.com/questions/328438/upstreaming-c...)
And the point of the whole feature is to document things without good canonical (or non-canonical) documentation:
- [Creating a topic which already has good official documentation - Meta Stack Overflow](http://meta.stackoverflow.com/questions/328569/creating-a-to...)
This is awesome. I can't count the number of times I've found an Android function that has almost no documentation. I usually post a question and answer on SO if I work out how it works. I only wish it were organised a bit more like normal documentation - i.e. into classes and methods. Might make it easier to find things.
Have you considered/tried adding back to the official documentation in cases like these?
I really don't want people to start using something like this instead of improving the official documentation. I hate the fact it probably cannot be helped. To "do the same thing for docs that we did for Q&A"? Yeah, except there just was no sane platform for Q&A before. And for docs there is, you know… the docs!
"The docs" are remarkably inconsistent between projects. "The docs" for C# really don't need any help, "the docs" (by which I mean the AFAIK unofficial cppreference.com) for C++ are fine. But even major languages like Python don't have the greatest documentation, never mind the thousands of libraries out there that have wildly disperate levels of official "docs".
Earlier quoted context omitted.
The UI needs some big improvements indeed. I toyed around with the site and although I could find my way around when just clicking through some topics, I am still confused as to what the structure of the site is (other than a list of topics, with a list of examples, not hierarchically structured or Q&A style or anything else that would make sense). I'm not sure I could find anything on here if I didn't get there via…
personally, google is how I always end up on stack overflow, so I'd imagine the same will be true for this product.
Will updated examples be run through a program testing them in some way? If not a full run within a playground-style environment, then through a type checker?
And will the examples be tagged with version numbers? Some programming languages are notorious for changing syntax and/or semantics between minor versions.
What I'm most worried about is the duplication between the canonical documentation of a project and the StackOverflow one. As the author of an open-source project, I try my best to write a great documentation, and I would be a bit annoyed if people started to add examples to StackOverflow just to gain reputation there instead of contributing to the "official" one. Also, SO is ranked way higher than the smaller-projec…
Now I need to resist the urge to just Google the question, I need to exert effort to find the documentation and make it handy.
What I'm most worried about is the duplication between the canonical documentation of a project and the StackOverflow one. As the author of an open-source project, I try my best to write a great documentation, and I would be a bit annoyed if people started to add examples to StackOverflow just to gain reputation there instead of contributing to the "official" one. Also, SO is ranked way higher than the smaller-projec…
The Stack Overflow Documentation content can be 'upstreamed' if it's worth doing so: - [Upstreaming content on Stack Overflow Documentation - Meta Stack Overflow]( http://meta.stackoverflow.com/questions/328438/upstreaming-c... ) And the point of the whole feature is to document things without good canonical (or non-canonical) documentation: - [Creating a topic which already has good official documentation - Meta Sta…
If anyone is wondering how this looks and is impatient to read the blog post, here's an example Documentation page for Java Streams - http://stackoverflow.com/documentation/java/88/streams#t=201...