Em apoio à proposta de documentação de Steem de @inertia (uma proposta SPS) | BlockTrades

Esta publicação é uma tradução autorizada por e para @blocktrades. Pode obter as informações no idioma original aqui: https://steemit.com/steem/@blocktrades/in-support-of-inertia-s-steem-documentation-proposal-an-sps-proposal

Eu estava revisando as propostas listadas no sistema SPS hoje e notei que a última proposta de @inertia para continuar a documentar a API Steem e as melhores práticas para trabalhar com esta API não foi votada, então eu queria explicar brevemente as razões pelas quais eu penso que esta deveria ser uma proposta que você, o leitor, deveria votar sem pensar duas vezes se quiser ver o ecossistema de Steem crescer.

1. A documentação das API é fundamental para apoiar o desenvolvimento de software centrado na blockchain de Steem. Se essa documentação não existir, cada grupo de desenvolvimento individual precisa fazer engenharia reversa da funcionalidade, duplicando efetivamente o esforço. E porque os novos desenvolvedores não estarão tão familiarizados com Steem, vai demorar muito mais tempo a fazê-lo.

2. Além disso, os novos desenvolvedores que não têm acesso a esta documentação são mais propensos a usar chamadas de API menos eficientes, o que pode fazer com que os sítios web sejam mais lentos e afetar negativamente a experiência do usuário em seus sítios web. E sem os exemplos certos, eles podem não empregar as melhores práticas de segurança em seus sítios web, aumentando a probabilidade de violações de dados essenciais privados.

3. O preço que inertia propõe para o trabalho é muito razoável, na minha opinião. No momento, 1 SBD equivale a aproximadamente 0,66 USD. Então está a pedir menos de $86 por dia para trabalhar 30% * 8 horas = 2,4 horas por dia (cálculos baseados na sua carga de trabalho proposta por dia). São 35,80 dólares por hora. Como alguém que contrata empreiteiros de software, posso prometer-lhe que é um preço fantástico para este tipo de trabalho. É realmente difícil encontrar programadores que estejam dispostos a escrever documentação, porque é uma das partes menos agradáveis da programação para a maioria dos programadores (por exemplo, se você é como a maioria das pessoas, pense em como foi quando teve que escrever um relatório de livro para a aula de inglês).

4. Esta é uma continuação de uma proposta de documentação anterior, e penso que fez um bom trabalho relativamente a essa proposta anterior e, inclusivamente, apresentou bons relatórios de progresso ao longo do caminho.

5. A outra alternativa, é claro, é esperar que o Steemit o faça (provavelmente levaria muito tempo, porque eles já têm seus próprios planos e internamente já "conhecem" as APIs) ou esperar que alguém altruísta o faça de graça. Mas como já mencionei, este é o trabalho menos divertido para os programadores, por isso não é muito provável que alguém o faça de graça.