Apareceu uma nova funcionalidade no Stackoverflow gringo chamada Documentation, veja:
Eu gostaria de saber o que é e se vamos ter aqui no SOpt também?
=D
Apareceu uma nova funcionalidade no Stackoverflow gringo chamada Documentation, veja:
Eu gostaria de saber o que é e se vamos ter aqui no SOpt também?
=D
Se vamos ter aqui eu não sei, duvido que a própria SE saiba no dia de hoje (ver data abaixo).
A SE viu uma "falha" no mecanismo atual e uma necessidade existente. O Q&A é ótimo para dúvidas específicas. Mas não é um formato tão bom para montar documentação de APIs e outras coisas. E ter uma forma colaborativa de montar documentação é algo muito interessante para todos, incluindo produtores de API e também para o próprio Q&A da SE que muitas vezes precisa linkar para uma documentação. Documentação que não existe, que está desatualizada, que deixa de existir, pelo menos naquele endereço linkado, entre outros problemas.
Por que não usar o know how adquirido com a gamificação do Q&A para fazer algo semelhante para a documentação? Daí nasceu o SO Docs.
Parte do mecanismo é o mesmo ou bem parecido, parte é novidade, mas lembra um pouco a dinâmica que já conhecemos.
A ideia dele é ter aquelas páginas de documentação mesmo. Pelo que percebi terá textos, mas o principal será o uso de exemplos de fazer alguma coisa. Receitinha de bolo.
A tendência é que vários projetos o adote com auxiliar ou deixe toda documentação no SO Doc.
É útil e ajudará evitar duplicatas no Q&A. Acho que a tendência é o Docs ter mais "o que fazer" e o Q&A ter mais o "porque fazer".
Gosto da ideia de ser mais colaborativo que o Q&A. Vamos ver o quanto dará certo. Seria bom. Está no caminho certo, aparentemente.
Tomara que dê muito certo e depois venham outras variantes para outros tipos de conteúdo que não se encaixam nem no Q&A, nem no Docs.
O bigown explicou muito bem:
A SE viu uma "falha" no mecanismo atual e uma necessidade existente. O Q&A é ótimo para dúvidas específicas. Mas não é um formato tão bom para montar documentação de APIs e outras coisas. E ter uma forma colaborativa de montar documentação é algo muito interessante para todos, incluindo produtores de API e também para o próprio Q&A da SE que muitas vezes precisa linkar para uma documentação.
A primeira parte, sobre nós ainda não sabermos se teremos aqui também, é verdade. Infelizmente, há uma série de coisas que ainda não resolvemos sobre como manter os sites internacionais funcionando. Não são problemas fáceis de resolver e adicionar mais coisas internacionais - seja Docs, Jobs, Teams, etc - só dificultaria a solução dos problemas.
Continuamos tentando consertar todos esses problemas, mas leva tempo. E até lá, não temos como dar uma resposta mais exata do que "provavelmente, um dia".
Stack Overflow Docs é o tema do segundo Estado da Pilha. Eu entro em mais detalhes sobre o que atravanca a habilitação do Docs no SOpt, como a tradução do site precisa ser resolvida se quisermos que ele continue se expandindo.
Tentei ser o mais claro o possível, considerando que é uma situação pra qual não temos resposta, e espero que possa ajudar vocês a entenderem melhor a situação do Docs. Além disso, estamos sempre abertos à sugestões. Se você tem alguma ideia do que pode ser feito pra melhorar o site, os comentários aqui embaixo (ou no blog) estão abertos!
Eu gostaria de saber o que é e se vamos ter aqui no SOpt também?
O Documentation foi um experimento feito pelo SOen que falhou e será desligado no dia 08/08/2017.