What Kind of Arabic Should we Use? about ar.reactjs.org

[asantarissy]

Are we just going to use it as is for the first version?

Thank you @obahareth, yes let's have a first version for now, and then we're definitely going to proofread everything and adjust it accordingly.

[fkanout]

Could you please mention that you want to rely on https://wiki.hsoub.com/React (as a start) in the contribution guide?

[aladin002dz]

we can use, for the first version, this translation:
https://wiki.hsoub.com/React

[obahareth]

Are we just going to use it as is for the first version?

[shakesBeardZ]

@obahareth it's not even an issue to raise I think we all agree as Arabic speakers that formal Arabic is the only Arabic that Arab people can understand, no offense but other accents can't be understood in other countries. take for example me as an Algerian I'll have difficulties fully understanding Egyptian or Saudi accent so the only way is to use formal one like any Arabic book.

[obahareth]

@shakesBeardZ

no offense but other accents can't be understood in other countries

That is very true, but the same is true with Formal Arabic as well, especially with younger audiences. I was born and raised in Saudi Arabia and I've lived most of my life there but I rarely ever get a chance to speak or write Formal Arabic, and as I mentioned before I know many who are in the same situation, and that number seems to be growing.

My intention was definitely not to imply that we should use a form of Colloquial Arabic specific to a certain region. I believe Modern Standard Arabic العربية الفصحى is the right basis for this (not necessarily formal) but I think we should try to use terms that are more well-known or more used, Which is why I gave the example of استدعاء vs مناداة (I've heard مناداة being used amongst Arab programmers far more than استدعاء, but of course I'm not saying we should base the translation based on what I've heard).

The whole point of opening this issue is because I don't feel the vocabulary in Hsoub's translation reflects how Arab programmers speak Arabic or even write it (for example in apps like Slack or PR reviews); even when using Modern Standard Arabic, in their day to day work; this is coming only from my limited experience with Arab programmers from a number of Arab countries.

I am not trying to say by any means that we should avoid or use any form of Arabic, but I felt that it was important to get the conversation started on this topic so that we as an open source community make an informed choice and get the opinion of other Arab programmers so this repository is written in a way that works for them, since they are the intended audience.

Even when making the choice to go with formal, I still think having our choices mentioned in the contributing guide is a must.

Do we write diacritics for a shadda? Some people do and some don't.
Do we use diacritics for everything? Most books don't, but if we want the reader of the docs to know how things are pronounced, then they're a must.

[shakesBeardZ]

@obahareth that being said , I think we all agree on what Arabic should be used to translate the content of any tech document (got u bro 😉 , I had the same issues with Maghribian scientific books in Arabic) to avoid confusion