search

deltachat-bot / bot-pages

Source of bots.delta.chat
https://bots.delta.chat
GNU General Public License v3.0
3 stars 0 forks source link

Easier language, shorter sentences, some grammar fixes #34

Closed lefherz closed 4 years ago

lefherz commented 4 years ago

I went over the pages and improved the text a bit.

I used hemingwayapp.com/ as a reference for what is good writing. The app puts a priority on short sentences which are easy to understand.

You can of course make an argument about whether the target group needs this. On the one hand, they have to understand the code itself as well, while this is already the translation code -> english. On the other hand, why introduce another artificial barrier?

github-actions[bot] commented 4 years ago

Response from respost

Check out the page preview at https://staging.bots.delta.chat/34/

pabzm commented 4 years ago

I don't think that the changes are in general an improvement, they are mostly about changing the style. hemmingwayapp.com produces suggestions that might be oriented by Hemmingway's style, but to me the results severely lack rhythm.

A few of those I can agree to, but not the whole lot. Should I pick? Or do you have a different suggestion how to proceed.

lefherz commented 4 years ago

Just pick some, I'd say :) either through suggestions to this PR, direct commits, or whatever you like.