a detail you probably didn't know: nowhere in any #curl documentation do we use the word "very".
-
@bagder @shaman007 I just don‘t think this example will either increase your productivity nor help the people reading the paragraphs in question. But if it makes you happy: keep up the enthusiasm.
@bitnacht @shaman007 Writing coherent and good documentation is a huge task. Avoiding a single word is just a tiny little bit of that and will of course in itself not make much of a difference. But I am convinced using coherent, proper and easily read language helps users. So we try to do that.
-
a detail you probably didn't know: nowhere in any #curl documentation do we use the word "very". It is a banned word enforced by a CI check. This rule encourages us to rewrite and instead use more appropriate words. Makes us write better English.
and now I'm about to drop all uses of "just"... https://github.com/curl/curl/pull/20793
-
@bitnacht @shaman007 Writing coherent and good documentation is a huge task. Avoiding a single word is just a tiny little bit of that and will of course in itself not make much of a difference. But I am convinced using coherent, proper and easily read language helps users. So we try to do that.
@bagder @shaman007 100% agree. And it is true that if you are forced to go over a text for a second time, you are likely to find ways to make it clearer and more concise along the way. So I see your point now.
-
and now I'm about to drop all uses of "just"... https://github.com/curl/curl/pull/20793
@bagder I am forever rewriting my docs and commit messages to remove "just" and "simply".
-
and now I'm about to drop all uses of "just"... https://github.com/curl/curl/pull/20793
@bagder You missed the opportunity to title the PR
"Just don't do it" -
R relay@relay.infosec.exchange shared this topic
