Este artículo es una traducción autorizada por y para @blocktrades. Puedes ver el artículo original en el siguiente enlace: https://steemit.com/steem/@blocktrades/in-support-of-inertia-s-steem-documentation-proposal-an-sps-proposal

Estuve revisando las propuestas listadas bajo el sistema SPS hoy y noté que la última propuesta de inertia para continuar documentando la API de Steem y las mejores prácticas para trabajar con esta API no ha sido votada (al menos), así que quise explicar brevemente las razones por las que creo que esta debería ser una propuesta "sin pensarlo dos veces" por la que usted, el lector, debería votar, si quiere ver crecer el ecosistema de Steem.

1. La documentación de la API es crítica para apoyar el desarrollo de software centrado en la cadena de bloques Steem. Si tal documentación no existe, cada grupo de desarrollo individual tiene que hacer ingeniería inversa de la funcionalidad, duplicando efectivamente el esfuerzo. Y como los nuevos desarrolladores no estarán tan familiarizados con Steem, les llevará mucho más tiempo hacerlo.

2. Además, existe una mayor probabilidad de que los nuevos desarrolladores que no tengan acceso a esta documentación utilicen llamadas a la API menos eficientes, lo que puede provocar que los sitios web sean más lentos y perjudiquen la experiencia del usuario en sus sitios. Y sin los ejemplos adecuados, es posible que no empleen las mejores prácticas de seguridad en sus sitios, lo que aumenta las posibilidades de que se produzcan filtraciones de datos de clave privada.

3. El precio que se pide por el trabajo es muy razonable, en mi opinión. En este momento, 1 SBD equivale aproximadamente a 0.66 USD. Así que está pidiendo poco menos de 86 dólares por día para trabajar el 30% * 8 horas = 2,4 horas por día (cálculos basados en su carga de trabajo propuesta por día). Eso es $35.80 por hora. Como alguien que contrata a contratistas de software, puedo prometerle que es un precio fantástico para este tipo de trabajo. En realidad es difícil encontrar programadores que estén dispuestos a escribir documentación, porque es una de las partes menos agradables de la programación para la mayoría de los programadores (por ejemplo, si eres como la mayoría de la gente, piensa en cómo fue cuando tuviste que escribir un informe de libro para la clase de inglés).

4. Esta es una continuación de una propuesta de documentación anterior, y creo que hizo un buen trabajo en esa propuesta anterior e incluso dio buenos informes de progreso en el camino.

5. La otra alternativa, por supuesto, es esperar a que Steemit lo haga (probablemente va a estar esperando mucho tiempo, porque ya tienen sus propios planes e internamente ya "conocen" las APIs) o esperar que alguien altruista lo haga gratis. Pero como ya he mencionado, este es el trabajo menos divertido para los programadores, así que no es un objetivo favorito para una contribución gratuita.

Nota del traductor

¡Chicos! Realmente apoyar este proyecto es algo super importante ya que, como mencionan los chicos de BlockTrades, incentivará completamente el desarrollo de futuras nuevas dApps que puedan crear los nuevos desarrolladores que se unan a la cadena de bloques, aquí les dejaré un link para que puedan votar directamente la propuesta y así asegurarás tu apoyo hacia una propuesta que beneficiará a Steem completamente en el largo plazo. ¡Muchas gracias por el apoyo de antemano! ¡Apoya la propuesta aquí!