TLDR é o que as “man pages” do Linux sempre deveriam ter sido

Se você ficar preso usando uma ferramenta Linux, a primeira porta de escala não deve ser o Stack Overflow, mas sim as “man pages”. Man – que é manual – apresenta a documentação de um determinado programa.

TLDR é outra maneira de ver a documentação. Em vez de ser um guia abrangente para uma determinada ferramenta, ele se concentra em oferecer instruções práticas orientadas, por exemplo sobre como algo funciona.

Pegue o wget , por exemplo. Esta é uma ferramenta usada para baixar arquivos da Internet. Para um utilitário Unix tão simples e diário, o wget tem uma página de manual estranhamente longa e complicada. Nem só isso oferece uma descrição detalhada do que faz, ele também exaustivamente lista seus muitos comandos – muitos dos quais raramente são usados.

TLDR

O TLDR, por outro lado, resume-se em algumas frases (“Baixe arquivos da Web. Suporta HTTP, HTTPS e FTP”) e oferece alguns exemplos de como usá-lo, com base em cenários da vida real. Você provavelmente encontrará em algum ponto: como baixar uma página da Web com todos os seus recursos ou recuperar o conteúdo de uma pasta FTP.

TLDR

Para aqueles pressionados por tempo, o TLDR é incrível. Eu não dependeria disso completamente , no entanto, como para alguns aplicativos, a documentação é extremamente incomum.

A página TLDR do Git, por exemplo, não cobriu quase nada sobre como usá-lo, salvar, como verificar a versão e como abrir as páginas de ajuda do Git. Algumas ferramentas não possuem documentação alguma; embora isso seja esperado quando você considerar que este é um esforço não oficial de terceiros.

Essas falhas são facilmente perdoadas, especialmente quando você considera que, em muitos casos, pode salvar uma viagem ao Google para descobrir como algo funciona. Para 99 % das pessoas que só precisam descobrir alguma sintaxe, e na verdade não querem ficar preso em um pântano de informações supérfluas, o TLDR é excelente. Embora nunca substitua verdadeiramente as man pages, elas as complementam bem.

Se você é curioso, pode verificar o site do projeto TLDR , que contém instruções de instalação e informações sobre como contribuir, se você estiver tão inclinado.

FONTE: THE NEXT WEB

One Ping

  1. Pingback: TLDR É O Que As “Man Pages” Do Linux Sempre Deveriam Ter Sido - PortaldoSaber

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *