Skip to main content

Respostas interessantes marcadas com a tag

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 ...
Maniero's user avatar
  • 484mil
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, é ...
Ricardo Pontual's user avatar
  • 23,2mil
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 ...
Rodolfo Faquin's user avatar
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 ...
Taisbevalle's user avatar
  • 9.180
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 ...
Maniero's user avatar
  • 484mil
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 ...
Tássio Auad's user avatar
  • 1.542
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 ...
Maniero's user avatar
  • 484mil
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 ...
Netinho Santos's user avatar
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])...
hkotsubo's user avatar
  • 66,9mil
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)...
Maniero's user avatar
  • 484mil
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 ...
Maniero's user avatar
  • 484mil
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. ...
Maniero's user avatar
  • 484mil
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: ...
hkotsubo's user avatar
  • 66,9mil
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) ...
hkotsubo's user avatar
  • 66,9mil
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 ...
Gabriel Coletta's user avatar
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 ...
hugocsl's user avatar
  • 66,9mil
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 ...
Daniel Silva's user avatar
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('...
Dudaskank's user avatar
  • 1.884
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.
Flaviano Honorato's user avatar
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 ...
mercador's user avatar
  • 2.790
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"/>
Bruno Costa's user avatar
  • 5.814
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 ...
Maniero's user avatar
  • 484mil
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 ...
Luiz Felipe's user avatar
  • 36,5mil
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 ...
DrunkPunk's user avatar
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 ...
Leonel Costa Braz's user avatar
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 ...
regmoraes's user avatar
  • 2.971
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 ...
Ricardo Pontual's user avatar
  • 23,2mil

Only top scored, non community-wiki answers of a minimum length are eligible