21
votos
Aceito
Existe documentação oficial para o JavaScript?
O que chamamos de JavaScript é uma implementação do ECMASCRIPT (ECMA-262). Existem várias versões que vão sendo desenvolvidas. Atualmente está implementada a versão 5 na maioria dos browsers.
No site ...
18
votos
Aceito
Documentação no desenvolvimento de software
Primeiro vamos diferenciar documentação e comentário. São coisas distintas com objetivos distintos e por isso tratamos de forma distinta.
E já vamos deixar claro que cada equipe sabe o que é melhor ...
18
votos
Aceito
Como ler o manual de ajuda do Git?
Tudo o que está entre colchetes são opcionais (lembrando que os colchetes em si não fazem parte da sintaxe, ele só existe para indicar isso na documentação), você usa apenas se fizer sentido para o ...
14
votos
Aceito
É uma boa prática utilizar <summary> para documentação?
O summary é usado pelo Visual Studio
Essa é a forma padrão de criar documentação para o código feito em C#. É daí que o Visual Studio tira as explicações sobre o que o método faz para mostrar quando ...
14
votos
Documentação no desenvolvimento de software
Qual seria uma boa forma de documentar o software?
Depende de várias coisas, mas eu diria que, inicialmente, seria seguindo o padrão de projeto que a comunidade que desenvolveu o padrão recomenda.
...
13
votos
Aceito
Como desenvolver manuais de usuários?
Para você não se preocupar tanto com a formatação, e conseguir focar na escrita do conteúdo da documentação, sugiro essas ferramentas:
usando o LaTex você aproveita um template de formatação já ...
13
votos
Aceito
Quais tags posso usar para documentar o meu código?
Você pode obter uma lista das principais tags do Javadoc na Wikipedia ou pode obter na documentação oficial.
Tag
Descrição
Onde usar
@author
Designer o autor do código
Class, Interface, Enum
@...
13
votos
É uma boa prática utilizar <summary> para documentação?
Sim.
Não apenas o <summary>, mas todos os itens de documentação. Essas informações são mapeadas pelo IntelliSense do Visual Studio e aparecem no Code Completion (completar-código).
Não apenas ...
10
votos
Aceito
Como documentar códigos em SQL?
Essa pergunta "How do you document your databases?" do dba.stackexchange tem algumas respostas interessantes.
Algumas das respostas aconselham usar as ferramentas:
SchemaSpy: baseada em Java (requer ...
10
votos
Aceito
Como ler corretamente uma documentação de um comando SQL?
A notação para documentação significa o seguinte:
{ } ou < >: o que está dentro de chaves é obrigatório, deve ser usado
{ x | y } ou < x | y >: deve ser escolhida uma opção, x ou y, é ...
8
votos
Desenvolvimento ágil e atualização da documentação
A questão é...
Quando sua equipe faz reunião ou você discute alguma funcionalidade com um colega desenvolvedor, você usa os diagramas?
Em caso afirmativo, então o uso deve ser cotidiano, portanto ...
8
votos
Aceito
Como é feita uma boa documentação usando SCRUM?
Alô, Ivcs!
Vou tentar responder a pergunta "Como é feita uma boa documentação usando SCRUM?" respondendo algo mais genérico como "Como é uma documentação ágil?", ok? Vou tentar ser bem informal e ...
8
votos
Aceito
O que é uma documentação formal?
Isto está querendo dizer que o comentário será usado para criar documentação.
O comentário de documentação formal deve ser público e muitas vezes é usado para criar documentação externa de uma forma ...
7
votos
Como desenvolver manuais de usuários?
Os softwares que ajudam fazer manuais de usuário são os comuns para ajudar produzir qualquer conteúdo escrito. Será principalmente um processador de texto e eventualmente outros que possam ajudar ...
7
votos
Aceito
O que é preciso para aprender classes e métodos específicos para uma tarefa?
Tudo o que pode usar está documentado. Pelo menos em bibliotecas que valem a pena usar. Toda informação básica do uso das classes está lá. Obviamente os métodos delas também.
O Android tem um site ...
7
votos
Aceito
No DevTools existe alguma maneira de captura a tela inteira do site, mesmo que tenha scroll?
Não sei se a solução a seguir se enquadra em:
Não procuro por extensão do Chorme ou código de captura de tela etc
Com o DevTools digite CTRL + SHIFT + P e a seguir abrirá o menu de comando
Em ...
6
votos
Aceito
Como transformar código fonte em resumo digital hash?
Tive as mesmas dúvidas que você ao fazer o registro de um dos sistemas aqui da empresa. Vou compartilhar aqui a forma que encontrei para criar o resumo digital hash.
1) Eu acessei nosso repositório ...
5
votos
Ler documentação XML gerada pelo Visual Studio
O Visual Studio consegue usar isto diretamente (na verdade é preciso só o compilador), mas se quer algo externo que faça algo mais sofisticado:
GhostDoc - bastante popular e fácil de usar
doxygen - ...
5
votos
É possível deixar o <summary> em Português?
De fato você já sabe que os hints que o Visual Studio mostra são obtidos nas descrições das tags <summary> contidas na documentação dos métodos. E deve entender que são programadores que ...
5
votos
Aceito
Erro Composer ao baixar phpDoc
A mensagem de erro diz:
the requested PHP extension xsl is missing from your system.
Ou seja, você precisa instalar a extensão xsl do PHP que é necessária.
No Ubuntu, use o comando a seguir:
$ ...
5
votos
Como ler corretamente uma documentação de um comando SQL?
As chaves são uma forma de agrupamento, significa que tudo que está ali dentro é uma coisa só, é como se fosse parênteses em uma expressão de programação normal que elimina a ambiguidade. Então ...
5
votos
Aceito
O que é UML? Para que serve?
UML ou Unified Modeling Language, como o nome diz é uma linguagem de modelagem, ou seja, ela deve descrever como um modelo de um domínio deve ser.
Ela foi padronizada pelo Object Management Group (OMG)...
4
votos
Aceito
Documentação em XML
Existe alguns modos de gerar a documentação do php, mas a maioria desses API's geram a documentação a partir de análises do seu código. Vou deixar alguns links aqui:
phpdocumentor
apigen
phpdox
...
4
votos
Aceito
Documentação sobre WPF com código C# puro
A documentação é o Docs da Microsoft, especificamente o namespace Windows. O ponto de partida da documentação é a FCL.
WPF tem 10 anos (na data que escrevi isto) e é usado apenas para desktop. Hoje ...
4
votos
Aceito
Consultar métodos, classes e atributos na linguagem C
C só possuem funções, constantes, tipos definidos, macros (que até somem antes da linguagem em si ser processada) e variáveis globais (ainda que raro, porque é desaconselhável). Uma forma de achar as ...
4
votos
Software para criar documentação sem usar o código-fonte
Eu estou desenvolvendo uma API
Então qual o problema em definir a API usando classes e interfaces e documentar o que cada método deve fazer?
Exemplo:
/**
* Esta classe deve implementar ...
4
votos
Por que um método privado não entra na documentação em Java?
void não vai mudará qualquer coisa, é só um indicador que o método não gera um resultado.
O que é privado é detalhe de implementação, é algo que pode ser mudado a qualquer momento sem prévio aviso. ...
4
votos
Aceito
Existe documentação no padrão ECMAScript que assegure que a um array ao ser passado como assessor de propriedade tenha um formato definido?
Isso não é exclusivo de arrays. Qualquer objeto, ao ser usado em um acessor de propriedade, acaba tendo seu método toString chamado, e esta string é usada como chave. Ex:
var k = {
toString: ...
3
votos
Como desenvolver manuais de usuários?
Você pode usar modelos do Editor de Textos para formatação do seu documento.
Se você dominar, você pode utilizar HTML com um Framework CSS e desenvolver um manual Web.
Você pode desenvolver um ...
Only top scored, non community-wiki answers of a minimum length are eligible
Tags relacionadas
documentação × 62c# × 10
java × 8
engenharia-de-software × 8
php × 7
api × 7
javascript × 5
visual-studio × 5
uml × 5
node.js × 3
comentários × 3
metodologia × 3
scrum × 3
summary × 3
android × 2
sql × 2
c × 2
sql-server × 2
.net × 2
git × 2
laravel-5 × 2
ubuntu × 2
composer × 2
versionamento × 2
biblioteca × 2