I understand this is (for now) for devs. I would love to see an equivalent (including private offering) for infra. Getting people to document things on the infra side is deplorable in general and I would love to try anything that helps improve that.
Introducing Stack Overflow Documentation Beta
131–136 of 136 posts
Re: Introducing Stack Overflow Documentation Beta
#132I 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".
Re: Introducing Stack Overflow Documentation Beta
#133Cool new project – I think it might become very helpful one day. Documentation for a lot of open source projects is pretty bad and having to figure out a new contributing workflow every time just to hop in and help a bit is quite problematic. Hopefully, the unified interface SO users are used to will give docs writing a big boost. That said, I still hope they output some sort of GitHub repo of all the accepted change…
The CC license used for stack overflow content is horrible. I have asked multiple lawyers what it means for cut-and-pasted code, and have yet to recieve a clear a definitive answer - is it viral when compiled into a binary, or when used in scripts? - how to attribute?
Re: Introducing Stack Overflow Documentation Beta
#134Earlier quoted context omitted.
Put the content AND the link, instead of just the link. This way, if the link changes the info will stay in SO.
But that violates DRY principle tho
Re: Introducing Stack Overflow Documentation Beta
#135I understand this is (for now) for devs. I would love to see an equivalent (including private offering) for infra. Getting people to document things on the infra side is deplorable in general and I would love to try anything that helps improve that.
"infra"? Quick google search did not illuminate me.