Skip to content

Conversation

@dev-thakku
Copy link

Translation of learn/installation page

@asimkt
Copy link
Collaborator

asimkt commented Jun 13, 2023

Thanks @dev-thakku

I need your opinion on this. I think most of the developers will still be using the english docs since that's also easy to understand. So our target user base is pakka newbie users who maynot be well versed with English or programming in general.

So in my opinion, we should rewrite the documentation in such a way that it's easy to understand with simple Malayalam words. The translation shouldn't look like a machine written one. What are your thoughts?

So the text

React has been designed from the start for gradual adoption. You can use as little or as much React as you need. Whether you want to get a taste of React, add some interactivity to an HTML page, or start a complex React-powered app, this section will help you get started.

We will read it, understand it, consider the intention and rewrite it in malayalam without losing the meaning, instead of doing a word to word translation? So something like:

നമുക്കു React ഏതു രീതിയിൽ വേണമെങ്കിലും ഉപയോഗിക്കാം. കാരണം React ഡിസൈൻ ചെയ്തത് തന്നെ ഘട്ടം ഘട്ടമായി പഠിക്കാൻ എളുപ്പത്തിൽ ആണ്. നമുക്ക് ഒരു വെബ്‌പേജിൽ കുറച്ചു ആക്ഷൻസ് കൊടുക്കണമെങ്കിൽ അല്ലെങ്കിൽ പൂർണമായും Reactൽ പ്രവർത്തിക്കുന്ന ഒരു ആപ്പ് ഉണ്ടാക്കണമെങ്കിലും React ഉപയോഗിക്കാവുന്നതാണ്.

I think our documentation should be targeting kids from 10th standard. Again, this is my personal opinion, and I would love to hear your thoughts. Small changes and updates we can do later as well, but if this is our pattern we're following it would be a great documentation.

@asimkt
Copy link
Collaborator

asimkt commented Aug 12, 2023

@dev-thakku Are you working on this? Can you share an ETA if possible?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants