In support of inertia's Steem documentation proposal (an SPS proposal)

in #steem5 years ago (edited)

I was reviewing proposals listed under the SPS system today and noted that inertia's latest proposal to continue documenting the Steem API and best practices for working with this API isn't voted in (yet at least), so I wanted to briefly the reasons why I think this should be a "no brainer" proposal that you, the reader, should vote for, if you want to see the Steem ecosystem grow.

  1. Documentation of the API is critical to support software development centered around the Steem blockchain. If such documentation doesn't exist, each individual development group has to reverse engineer the functionality, effectively duplicating effort. And as new developers won't be as familiar with Steem, it will take them much longer to do.

  2. In addition, there is a higher probability that new developers without access to this documentation will use less efficient API calls, which can lead to slower web sites that detract from the user's experience on their sites. And without proper examples, they may not employ the best security practices on their sites, increasing the chances for things like leakage of private key data.

  3. The price being asked for the work is very reasonable, IMO. As of this moment, 1 SBD is approximate 0.66 USD. So he's asking just under $86/day to work for 30% * 8 hours = 2.4 hours per day (calculations based on his proposed workload per day). That comes to $35.80 per hour. As someone who hires software contractors, I can promise you that is a fantastic price for this type of work. It's actually hard to find programmers who are willing to write documentation, because it's one of the least enjoyable parts of programing for most programmers (e.g if you're like most people, think about what it was like when you had to write a book report for English class).

  4. This is a continuation of a prior documentation proposal, and I felt he did a good job in that prior proposal and even gave nice progress reports along the way.

  5. The other alternative, of course, is to wait for either Steemit to do it (probably going to be waiting a long time, because they already have their own plans and internally they "know" the APIs already) or hope for someone altruistic to do it for free. But as I mentioned already, this is the least fun work for programmers, so its not a favored target for a free contribution.

All rewards from this post have inertia as a beneficiary (assuming I did this right, it's my first time playing with this setting)...

Sort:  

Thanks, it's encouraging to see support like this. Although I often will go with "no feedback is good feedback," there's something to be said for someone going out of their way to highlight support.

Hijacking top comment to add the link to approve the proposal.

You want to click here --> Right here, this text, click it, then follow the prompts.

Ps: You can post up to 5 times a day and they'll all be upvoted

You did.

Consider adding a link to approve the proposal as many have no idea how it works.

This is how I did it.

[Approve Proposal](https://beta.steemconnect.com/sign/update-proposal-votes?proposal_ids=[42]&approve=true)

Just change the proposal number.

There's multiple ways to vote for the proposal, so I don't know that I should favor any potential platform for that.

I really hope that anyone who has a significant stake in Steem will take the time to learn how to vote on proposals, in whatever manner they prefer. But I doubt most people will want to do it like I do. I only vote for proposals with the command-line wallet (CLI wallet) because proposal voting requires use of an active key.

I think the majority of people use SteemConnect/Keychain. The ones that don't will know how to do it anyway.

Click this to make it rain on @inertia --> This is what you click

Already voted. ✓

Thanks for the reminder dear @blocktrades.

@inertia is known well for his great work.
Full support from the beer world!

It goes to say Inertia does invaluable work here and will have much more value as Steem matures. Good to see the support .

Posted using Partiko iOS

I'm not a programmer. I don't know anything.
I don't know if most poor people here would agree to $35.80 per hour.
That amount is too much for me IMHO, as one of the poor people here.

I guess we have also to consider how much money @inertia already earned on steem ecosystem and maybe lower the cost of his expertise.

And in the future, how do we know that those recommended people for the proposals are not the same person or people or maybe the same group of friends trying to monopolize this system?

You aren't a programmer and you don't know anything (your words) but you say he is potentially going to be paid too much? What he's doing it pretty invaluable. If you understood how software is built, you would not have written this comment. I promise.

That is such a backward way of thinking. So because you are "poor" you think that someone else should earn less? What inertia has earned in the past is irrelevant, would you be ok in taking a job with less earnings just because you earned some money in another job?

And in the future, how do we know that those recommended people for the proposals are not the same person or people or maybe the same group of friends trying to monopolize this system?

For pete's sake! Ask around, everyone who has been here long enough (and is actually interested in finding out) knows who is inertia.

Besides, what's important is the actual proposal. If you actually read the post you would understand that the work that is being proposed would potentially benefit all of us in the long run and make you less "poor".

@ronel. Please don't embarrass yourself 😖😓😖. Delete this comment ASAP.

Posted using Partiko Android

He won't be able to because it has been replied to already, including by you.

He can still edit it.

He can edit it. The comment looks really weird. Negative energy without sound knowledge.

Posted using Partiko Android

for it-consultancy in the land of the free leaders of the west and europe thats not really a very high wage, relatively speaking ... but i understand what you mean there, in some places thats a weeks food , right or more ... dont have to tell me i count €5 a day as budget normally but well yea , its not really all that preposterous if youd see some of the fees consultants get here lol
, as for the proposal, i voted for it weeks ago if im not mistaken, those docs can use some SERIOUS maintenance ... a bit of php libs would be nice too for the $36/hour lol (but im guessing it mostly python, right ? the in-thing .. and maybe the ancient nodejs but fine yea im all for it one of the best proposals i saw ... good a titan like @blocktrades actively follows up those things

and never mind those people calling you names because you dont know coding .. its ... well some of that is pretty much elite and some of them feel like that because they can .. .(i have no idea why really but thats how it is ... dont lose sleep over it)

and also (chucklze ... i hope i dont get the evil eye now ) ::

its a free market now : anyone can come in with the same proposal and underprice it ... :)
and if no one does then either no one's interested or confident enough ....

'free market' :)

as perspective , i knew guys personally who got 'rented out' for like over 1200 an hour, now that's not what they get and in soviet hellgium here after taxes that's not what the bossman gets either

but that's what they cost to the companies temporary hiring them ... the worlds a bit skewed on the moneyside

This is a continuation of his previous proposal, so you may need to vote for the new one if you only voted for the first one. A couple of voters have already told me that they didn't realize there was a second proposal that needed to be upvoted to continue the work after his previous proposal expired.

Ridiculous . I recently got into a discussion about “poor” people and the gist of what the person was saying was Steem should support all poor people . You realize this would wreck Steem ? Inertia earned and yes, even bought Steem. This doesn’t mean the hates poor people .

Posted using Partiko iOS

lol, $36/hr is a really low wage for a skilled worker in the US or Europe. Coincidentally the cost of living in these places in a decent city is extremely high.

Skilled workers need to be paid a fair wage for their talents commensurate to what they could make elsewhere.

Let the rich people vote for the proposal and poor are free to counter it. Let's see who win ...he he he!

I read somewhere, to get richer, you should think and act the way rich think! ...else poor are doomed to remain poor.

Here's the thing he did almost NO work on his proposal to convince the generic user that we should support his proposal... in fact YOU have made a better case for him than he made for himself. He basically shared a link expecting hundreds of non-developers to know what he's talking about... and we don't know... and maybe that's fine because we're not his target for the proposal since maybe it's just aimed at the 4-5 accounts that can make his proposal successful regardless of the rest of us.

So thanks for sharing ... I was also hoping to hear more about the results of his last proposal.

I'm not even remotely interested in discussing how good he is at selling his work to non-developers. He's not a marketing guy, and it turns out, he probably doesn't need to hire a marketing guy to write his proposal posts, because he can get endorsements from other programmers who recognize the importance of this work. To me, that's a win for the blockchain, as I don't particularly want people wasting time on things they aren't good at. This isn't a competition, it's a cooperative effort to build a better ecosystem.

I can easily see why non-programmers might not understand the importance of this work, and, yes, that's why I wrote my post about it.

As far as his previous proposal, he published a bunch of links regarding his work that were fairly comprehensive in terms of what he did. Really more comprehensive than I thought was strictly needed.

By results, do you mean what he did, or what the ultimate impact of that work is? The latter isn't something that can easily be pinned down, and I really don't want to see him try to. I get so tired of seeing BS marketing resumes from people claiming things like "my work generated 25 million dollars for my previous employer over a one year period". Basically numbers pulled out of their butt, IMO. Note it wasn't typically progammers generating resumes like that, it was almost always a manager's resume.

You do realize i was thanking you for the post you made right?

As a developer, I value his work greatly. When I first came to Steem, there was very little in way of documentation and no one really wanted to help.

Good documentation prevents developers from coming to Steem and getting pissed off they can't figure out how things work and moving on.

Steem will live and die on the dApps and not the blogging.

Voted. Like last time. Thanks for reminding us about the latest proposal. @inertia does great work.

Already Supported

Coin Marketplace

STEEM 0.30
TRX 0.12
JST 0.033
BTC 63155.22
ETH 3108.25
USDT 1.00
SBD 3.85