Stopwords - better explanation for translators

[pavelevap]

Stopwords should have better comments for translators. There are many not so clear things, I guess...

• One-letter words can be also added or these are filtered automatically? For example, there is missing "a" in English version (but I noticed it in comment for translators). So, should I miss one-letter words too?

• Should we use diacritic marks? For example in Czech we have two words "právě" and "pravé". Should I add these 2 words to list or use only version without diacritic marks "prave"? All stopwords are modified to english "a-z" form in the end?

• When search term is "stopword + word", then "word" is searched and also the whole phrase "stopword + word"? When search term is only "stopword", then "stopword" is searched? When search term is "stopword + stopword", then only the whole phrase "stopword + stopword" is searched?

Translators should know these details, I guess...

[ocean90]

Not sure if it should be a translator comment. What about a link to a codex page?

[netweb]

Related: #25585

[DrewAPicture]

We should be able to add a sub-section to the ​Translating WordPress article in the Codex.

See ​http://make.wordpress.org/docs/2014/03/31/looking-for-a-volunteer-to-add-a/

[yoavf]

Created ​http://codex.wordpress.org/Translating_WordPress#Stop_Words
On top of what's already in the translators comment, I added some notes regarding single letter words and diacritics.

[DrewAPicture]

Replying to yoavf:

Created ​http://codex.wordpress.org/Translating_WordPress#Stop_Words
On top of what's already in the translators comment, I added some notes regarding single letter words and diacritics.

Thanks for doing that Yoav! Closing this as fixed.

[pavelevap]

Codex page is fine, but we should also repair translators comment suggesting to use single letter word "a":

https://core.trac.wordpress.org/browser/trunk/src/wp-includes/query.php#L2046

Also on Codex page is example with single letter words which is misleading.

Do you have idea how stopwords work as regards my third point? One user also asked me about it and I was not sure about right answer.