BT

Stack Overflow lança a ferramenta Documentation

| por Abel Avram Seguir 7 Seguidores , traduzido por Marcelo de Castro Seguir 0 Seguidores em 22 set 2016. Tempo estimado de leitura: 1 minuto |

O Stack Overflow lançou um nova ferramenta chamada Documentation, que permite que desenvolvedores criem documentação, voltada a desenvolvedores, sobre vários tópicos relacionados ao desenvolvimento de software.

Ao contrário do site Stack Overflow Q/A (perguntas e respostas) que tem como objetivo responder questões específicas, a nova ferramenta pretende fornecer documentação de referência e instrutiva sobre várias tecnologias de programação, ou seja, funcionando como um manual na web escrito por desenvolvedores.

A ferramenta é organizada por meio de uma lista de quase 50.000 tags, das quais vieram do site Stack Overflow de perguntas e respostas. Neste início, apenas algumas centenas de tags tiveram a documentação iniciada. A documentação referente à cada tag está organizada em tópicos com exemplos que explicam o tema, seguidos pelas seções Syntax (Sintaxe), Parameters (Parâmetros) e Remarks (Observações). Por exemplo, a tag "Java Language" tem o maior número de tópicos (90 e aumentando), incluindo Arrays, Streams, String, Generics, Lambda Expression e outros.

O tópico Arrays inclui 15 exemplos que mostram como criar, ordenar, iterar, comparar, converter e executar outras operações com vetores. Cada exemplo normalmente contém algum texto e trechos de código que demonstram o uso do recurso. A seção Syntax contém documentação concisa enquanto em Parameters pode ser adicionada informação sobre parâmetros de um construtor ou método. A seção Remarks (Observações) é opcional.

Documentation está aberto para todos que queiram contribuir ou fornecer feedback. Um sistema de votação faz com que alguns exemplos se tornem mais populares que outros. O sistema de reputação existente no StackOverflow Q/A foi estendido ao StackOverflow Documentation, acumulando os pontos de ambos sites.

Desenvolvedores de diversas empresas de tecnologia participam para tornar a ferramenta Documentation melhor, incluindo desenvolvedores da Microsoft, Xamarin, PayPal, Meteor, Dropbox e outras. É esperado também que outras empresas venham a contribuir no futuro, a fim de levar manuais de suas tecnologias ao StackOverflow.

Avalie esse artigo

Relevância
Estilo/Redação

Olá visitante

Você precisa cadastrar-se no InfoQ Brasil ou para enviar comentários. Há muitas vantagens em se cadastrar.

Obtenha o máximo da experiência do InfoQ Brasil.

Dê sua opinião

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão
Comentários da comunidade

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão

Dê sua opinião

Faça seu login para melhorar sua experiência com o InfoQ e ter acesso a funcionalidades exclusivas


Esqueci minha senha

Follow

Siga seus tópicos e editores favoritos

Acompanhe e seja notificados sobre as mais importantes novidades do mundo do desenvolvimento de software.

Like

Mais interação, mais personalização

Crie seu próprio feed de novidades escolhendo os tópicos e pessoas que você gostaria de acompanhar.

Notifications

Fique por dentro das novidades!

Configure as notificações e acompanhe as novidades relacionada a tópicos, conteúdos e pessoas de seu interesse

BT