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 ...
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, é ...
10
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 ...
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 ...
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 ...
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 ...
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
Por que em documentação a vírgula fica do lado de dentro?
Os colchetes indicam que o parâmetro é opcional. A vírgula fica dentro dos colchetes porque ela própria faz parte de todo o conteúdo que é opcional.
Ou seja, se fosse assim:
JSON.parse(text,[ reviver])...
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)...
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 ...
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
Aceito
Onde encontro a referência para definição de datas do formato dd/mm/yyyy?
Use o formato ISO 8601
Depende muito do que você quer fazer com sua API, mas em geral, um formato de data específico para cada localidade é um problema de apresentação. Internamente o(s) seu(s) ...
3
votos
Aceito
Herdar comentários de um objeto virtual
Com o ReSharper (e possível outras ferramentas), você consegue replicar o comentário com Alt+Enter na definição, vai ter uma opção copiar a documentação do base.
Mesmo com essa possibilidade, esteja ...
3
votos
Aceito
Como documentar CSS?
Exitem formas sim de documentar o CSS, eu vejo dois caminhos para isso. O primeiro seria padronizar a escrita do CSS dentro de um time. Algumas empresas já usam isso, inclusive a Google e a Mozilla ...
3
votos
Como é feita uma boa documentação usando SCRUM?
Por ser uma metodologia ágil o Scrum parte do pré-suposto que a equipe é pró-eficiente, ou seja, consegue produzir o máximo de valor com o mínimo de artefato quando falando em documentação. Isto gera ...
3
votos
Aceito
PHP - Adicionar marca D'agua em um DOC ou PDF
Parece que é possível sem grandes problemas...
Para PDF, tem a biblioteca PDF Watermarker. Exemplo de uso dela:
<?php
require_once('pdfwatermarker/pdfwatermarker.php');
require_once('...
2
votos
Opções para gerar documentação de API em Laravel
uma das mais conhecidas e muito usada é o http://swagger.io/, inclusive estou usando neste momento em uma api aqui.
2
votos
Aceito
Opções para gerar documentação de API em Laravel
Laravel API Documentation Generator: https://github.com/mpociot/laravel-apidoc-generator
O repositório no GitHub inclui instalação, modo de usar e possíveis configurações que você possa achar ...
2
votos
Herdar comentários de um objeto virtual
Tem também a possibilidade de herdar a documentacao, tal como deseja.
Para fazer isso use o <inheritdoc cref=""/>
Exemplo:
/// <inheritdoc cref="object.ToString"/>
2
votos
Aceito
Os atributos de uma superclasse são considerados também atributos da subclasse?
Documentar é convenção, as regras são adotadas de acordo com o jeito que a pessoa/equipe determina que deva ser. Algumas ferramentas que ajudam documentar só trabalham de uma determinada forma. Então ...
2
votos
Existe documentação no padrão ECMAScript que assegure que a um array ao ser passado como assessor de propriedade tenha um formato definido?
Em JavaScript, objetos são coleções de propriedades. No entanto, uma restrição importante ocorre para as chaves dessas propriedades.
Por design, a linguagem optou por permitir apenas chaves do tipo ...
1
voto
Existe um padrão de documentação/comentários de software em ReactJs
Acho que o código em si, só é uma boa comentar caso seja uma função muito específica e que pode gerar alguma duvida para outro dev. Mas o ideal é que o código seja escrito da melhor forma possível ...
1
voto
Hierarquia de templates - Wordpress
Fala Peter.
Como você mesmo citou, a imagem da documentação já dá uma boa ajuda. Vou fazer um possível caminho e você responde com dúvidas se tiver. Então, basicamente é só criar os arquivos na pasta ...
1
voto
Existe algum padrão para documentação da arquitetura de uma aplicação android?
Para documentar a arquitetura de qualquer projeto de software, o ideal é utilizar a UML, pois ela é uma linguagem bastante conhecida e que fornece todos os elementos para representar elementos de ...
1
voto
Diferença entre "Relacionamento de extensão" e "Ponto de Extensão"
A diferença é o que ponto de extensão define um determinado estado, condição ou pré-requisito para que a extensão aconteça.
Enquanto a extensão acontece quando um caso de uso é concluído, o ponto de ...
Only top scored, non community-wiki answers of a minimum length are eligible
Tags relacionadas
documentação × 66c# × 11
java × 8
api × 8
engenharia-de-software × 8
php × 7
javascript × 5
visual-studio × 5
uml × 5
node.js × 4
.net × 3
comentários × 3
metodologia × 3
swagger × 3
scrum × 3
summary × 3
android × 2
python × 2
sql × 2
sql-server × 2
orientação-a-objetos × 2
xml × 2
git × 2
laravel-5 × 2
ubuntu × 2