Cloudron docs riddled with egregious spelling and grammar errors
dis no look vry proofesional.
Pro tip: Spellcheckers are a thing. Use them when creating verbiage that will be customer-facing!
whn u chats wiz ur frends, speling annd gramar nott soo importunt.
But if you want people to pay you $180 per year to use Cloudron, well, ummm, yeah... break out that spiffy little spellchecker you've got gathering dust in your closet (/sarcasm) and pay a native speaker to proofread your text.
Ha ha, fair criticism. Most of the docs are written by me and I and not a native speaker. I copy/pasted the docs into some grammar websites and they did find some obvious typos. I will try to get them fixed over the week.
If you are interested in helping, our docs are at https://git.cloudron.io/cloudron/docs.
I suggest you contact a dozen or so freelancers on Fiverr.com. (By the way, they are referred to as "sellers" not "freelancers" on Fiverr.com). I suggest you ask them simply, "How much would you charge to proofread/clean up https://git.cloudron.io/cloudron/docs?"
I would guess you would need to pay, say, 10 US dollars to 20 US dollars to each freelance proofreader whom you were to engage. I suppose a native speaker who enjoys and is good at proofreading, would need to spend approximately an hour to complete the task properly.
However, you might need to test out several freelancer proofreaders before you find one you like. I guess the project might cost you guys somewhere around 60 US dollars for three freelance proofreaders instead of, say, around 50 US dollars, because, if I am not mistaken, Fiverr would charge you a 20% fee.
However, once you find a freelancer you like, you'd probably be able to work with that person on an ongoing basis because I assume proofreading/editing text on cloudron.io would be easy work for a native speaker who enjoys that sort of work.
Like most startups, cloudron.io will probably fail. To increase your chances of success you guys need... 2b sur yur websight luks proofesional.
Because you are a non-native speaker—who I presume is an engineer—frankly, you'll probably never be a good writer in the English language. But well, hmmm... at the end of the day: who cares? None of us are good at everything; to earn money we only need to be good at something marketable!
@yeku thanks for the suggestion, will keep that in mind.
Like most startups, cloudron.io will probably fail.
For some background, we are not a startup and more like an indie software shop. We haven't taken any investment and our company growth and revenue goals are not like a startup. We have been around for over 5 years now and reasonably successful and have a net profit. In fact, we make enough to contribute to upstream projects now. TBH, if anything, we want to make more money, not for ourselves but to help other projects even more.
@girish Thanks for letting me know. I wish you well.
scooke last edited by
@girish I'm now curious about all these egregarious errors! So I'll take a look. You all have terrific attitude, btw. Keep up the good work.
@girish saw this on reddit after reading this thread: https://www.reddit.com/r/opensource/comments/pa2esx/english_grammar_checking_cl_tool_to_add_to_ci/
One of the suggested solutions looks decent: https://languagetool.org/
ruihildt last edited by
@my1water Language Tool could be packaged for Cloudron.
@my1water ah, languagetool is indeed quite nice. I just installed their extension, let's see how it goes.
scooke last edited by girish
marcusquinn last edited by girish
robi last edited by robi
bubonicfred last edited by
@girish I tried to sign in to the git with both github and gitlab and failed cause of the non-approved email thing, which I thought was fixed?
I've recently installed language tool and I am enjoying it.
I've also used proselint in the past, which aims to improve writing with a low false alarm rate. http://proselint.com/
There's also https://github.com/btford/write-good which is aimed at developers (and probably a few others too)
I'm now curious if either of those can be implemented as tests for pull requests?
scooke last edited by
timconsidine last edited by
@yeku I understand the points, but I have only seen a couple of errors, and they haven't prevented me getting the message or successfully using Cloudron.
I think Cloudron have enough work running a fantastic architecture. The community here can help out @girish free of charge with great enthusiasm. Errors just need to be reported and they can be fixed quickly.