Merge branch 'master' of https://github.com/javascript-tutorial/my.javascript.info

Author: Jzeemo

1-js/01-getting-started/1-intro/limitations.svg

@@ -2,55 +2,72 @@
 
 <!-- # Manuals and specifications -->
 
-
 <!-- This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other sources. -->
-ဒီစာအုပ်က *tutorial* တစ်ခုဖြစ်ပါတယ်။ JavaScript ကို တစ်ဖြည်းဖြည်းချင်း လေ့လာနိုင်အောင် ရည်ရွယ်ထားတယ်။ တကယ်လို့ အခြေခံ အချက်တွေကို နားလည်သွားပြီဆိုရင် တခြား လေ့လာစရာတွေကို ထပ်လေ့လာဖို့ လိုပါလိမ့်မယ်။
+
+ဒီစာအုပ်က _tutorial_ တစ်ခုဖြစ်ပါတယ်။ JavaScript ကို တစ်ဖြည်းဖြည်းချင်း လေ့လာနိုင်အောင် ရည်ရွယ်ထားတယ်။ တကယ်လို့ အခြေခံ အချက်တွေကို နားလည်သွားပြီဆိုရင် တခြား လေ့လာစရာတွေကို ထပ်လေ့လာဖို့ လိုပါလိမ့်မယ်။
 
 <!-- ## Specification -->
+
 ## သတ်မှတ်ချက်
 
 <!-- [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language. -->
+
 [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) ဆိုတဲ့ သတ်မှတ်ချက် တွေမှာ JavaScript နဲ့ ပတ်သတ်ပြီး အသေးစိတ် , အခြေခံကျကျ နဲ့ တိကျတဲ့ အချက်အလက်တွေ ပါဝင်ပါတယ်။
 
 <!-- But being that formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use. -->
+
 အဲ့လို အသေးစိတ် အချက်အလက်တွေ ကြောင့်ပဲ အစပိုင်းမှာ နားလည်ဖို့ ခက်ခဲ့ပါတယ်။ ဒါကြောင့် language ရဲ့ အချက်အလက် တွေနဲ့ ပတ်သတ်ပြီး ယုံကြည်ရတဲ့ ရင်းမြစ်တစ်ခုလိုနေတယ် ဆိုရင် သတ်မှတ်ချက်တွေ ကို လေ့လာတာက မှန်ကန်တဲ့ အရာပါပဲ။ ဒါပေမယ့် နေစဉ်အသုံးပြုဖို့တော့ မဟုတ်ပါဘူး။
 
 <!-- A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>. -->
+
 နှစ်စဉ်နှစ်တိုင်း သတ်မှတ်ချက် အသစ်တွေ ထွက်ပါတယ်။ အဲ့ မထွက်ခင် အတောအတွင်း သတ်မှတ်ချက်တွေကို <https://tc39.es/ecma262/> မှာ သွားကြည့်လို့ရပါတယ်။
 
 <!-- To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at <https://github.com/tc39/proposals>. -->
+
 အသစ်ထွက်လာမယ့် features တွေ "almost standard" (so-called "stage 3") လို့ခေါ်တဲ့ standard ဖြစ်တော့မယ့် features တွေအကြောင်းဖတ်ချင်ရင် <https://github.com/tc39/proposals> သွားဖတ်လို့ရပါတယ်။
 
 <!-- Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial. -->
+
 နောက်ပြီးတော့ တကယ်လို့ သင်ဟာ brower အတွက် ဖန်တီးနေတဲ့သူဆိုရင် browser environment တွေအတွက် သတ်မှတ်မှတ်ချက် တွေကို ဒီ tutorial ရဲ့ [second part](info:browser-environment) မှာ ပြောပြသွားပါမယ်။
 
 <!-- ## Manuals -->
+
 ## Manual
 
 <!-- - **MDN (Mozilla) JavaScript Reference** is the main manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc. -->
+
 **MDN (Mozilla) JavaScript Reference** ကတော့ ဥပမာ တွေနဲ့ အခြားအချက်အလက်တွေအတွက် အဓိက ဖြစ်ပါတယ်။ language နဲ့ ပတ်သတ်တဲ့ functions တွေ methods တွေ နဲ့ ပတ်သတ်ပြီး အသေးစိတ် အချက်အလက်တွေ လေ့လာဖို့အတွက် ကောင်းတဲ့ နေရာပါပဲ။
-    <!-- One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>. -->
-    <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> ဒီမှာ သွားကြည့်လို့ရပါတယ်။
+<!-- One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>. -->
+<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> ဒီမှာ သွားကြည့်လို့ရပါတယ်။
 
 <!-- Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for `parseInt` function. -->
+
 တစ်ခါတစ်လေကျရင် internet မှာပဲ ကိုသိချင်တာကို ရှာလိုက်တာက ပိုကောင်းနိုင်ပါတယ်။ အဲ့လို အခြေမျိုးဆိုရင် "MDN [term]" ဆိုတဲ့ စာလုံးလေး ထည့်ပြီးရှာပါ။ ဥပမာ <https://google.com/search?q=MDN+parseInt> ဆိုပြီး `parseInt` အကြောင်းကို ရှာနိုင်ပါတယ်။
 
 <!-- ## Compatibility tables -->
+
 ## တွဲဖက်လုပ်ဆောင်နိုင်မှု
 
+=======
+
 <!-- JavaScript is a developing language, new features get added regularly. -->
+
 JavaScript ဟာ တိုးတက်နေဆဲ language တစ်ခုဖြစ်ပါတယ်။ features အသစ်တွေကိုလည်း ပုံမှန် ထည့်သွင်းပေးနေပါတယ်။
 
 <!-- To see their support among browser-based and other engines, see: -->
-သူရဲ့ browser အခြေခံ နဲ့ တစ်ခြား engines တွေမှာ တွဲဖက်လုပ်ဆောင်နိုင်စွမ်းကို ကြည့်ချင်ရင် : 
+
+သူရဲ့ browser အခြေခံ နဲ့ တစ်ခြား engines တွေမှာ တွဲဖက်လုပ်ဆောင်နိုင်စွမ်းကို ကြည့်ချင်ရင် :
 
 <!-- - <http://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <http://caniuse.com/#feat=cryptography>. -->
+
 - <http://caniuse.com> - feature တစ်ခုချင်းစီအတွက် ထောက်ပံမှု , ဥပမာ ဘယ် engines က တော့ ဘယ် cryptography funnctions ကို ထောက်ပံပေးထားတယ် ဆိုတာမျိုး <http://caniuse.com/#feat=cryptography>
 <!-- - <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support. -->
 - <https://kangax.github.io/compat-table> - ဘယ် engines တွေက ဘယ် language features တွေကို ထောက်ပံပေးလည်းဆိုတာ ဖော်ပြထားတဲ့ table တစ်ခုပါ။
 
 <!-- All these resources are useful in real-life development, as they contain valuable information about language details, their support etc. -->
+
 အပေါ်က အချက်အလက်တွေက တကယ်လက်တွေ့ ဖန်တီးမှုတွေမှာ အရမ်းကို အသုံးဝင်ပါတယ်။ သူတို့မှာ တန်ဖိုးရှိတဲ့ language အသေးစိတ် အချက်အလက်တွေ နဲ့ သူတို့ရဲ့ ထောက်ပံမှုတွေ စသည်ဖြင့် ပါဝင်ပါတယ်။
 
 <!-- Please remember them (or this page) for the cases when you need in-depth information about a particular feature. -->
+
 ဒါကြောင့် အကြောင်းအရာ တစ်ခုခုနဲ့ ပတ်သတ်ပြီး အသေးစိတ်လေ့လာဖို့ လိုအပ်လာပြီဆိုရင် အဲ့ဒီ page တွေကို သွားရောက် လေ့လာဖို့ သတိရပါ။

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -1,47 +1,58 @@
 # Code editors
 
 <!-- A code editor is the place where programmers spend most of their time. -->
+
 code editor ဆိုတာကတော့ programmers တွေ အချိန်အများကြီး တူတူ ရှိနေတဲ့ အရာပါပဲ။
 
 <!-- There are two main types of code editors: IDEs and lightweight editors. Many people use one tool of each type. -->
-IDEs နဲ့ lightweight editors ဆိုပြီး အဓိက code editors နှစ်မျိုး ရှိပါတယ်။ လူတော်တော်များများက အဲ့ နှစ်ခု ထဲက တစ်ခုကို သုံးကျပါတယ်။
+
+IDEs နဲ့ lightweight editors ဆိုပြီး အဓိက code editors နှစ်မျိုး ရှိပါတယ်။ developer တော်တော်များများက အဲ့ နှစ်ခု ထဲက တစ်ခုကို သုံးကျပါတယ်။
 
 ## IDE
 
 <!-- The term [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) refers to a powerful editor with many features that usually operates on a "whole project." As the name suggests, it's not just an editor, but a full-scale "development environment." -->
+
 [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) ဆိုတာက project တစ်ခုလုံးအတွက် လိုအပ်တဲ့ features တွေ တော်တော်များများပါတဲ့ editor တစ်ခုပါပဲ။ IDE ဆိုတဲ့ နာမည်အတိုင်း editor တစ်ခုအနေနဲ့သာမက development environment တစ်ခု အစအဆုံး အလုပ်လုပ်နိုင်ရန် အပြည့်အဝ အထောက်အကူပေးပါတယ်။
 
 <!-- An IDE loads the project (which can be many files), allows navigation between files, provides autocompletion based on the whole project (not just the open file), and integrates with a version management system (like [git](https://git-scm.com/)), a testing environment, and other "project-level" stuff. -->
+
 IDE တစ်ခုဟာ project files အကုန်လုံးကို load လုပ်နိုင်ခြင်း ၊ file တစ်ခုကနေ နောက်တစ်ခုကို ညွှန်ပေးနိုင်ခြင်း ၊ project တစ်ခုလုံးအတွက် စာရိုက်ရာတွင် အလိုအလျောက် ပေါ်ပေးခြင်း (autocompletion) ၊ version management system တွေနဲ့ အလုပ်လုပ်နိုင်ခြင်း ဥပမာ [git](https://git-scm.com/) ၊ testing လုပ်နိုင်ခြင်း အပြင် အခြားသော လုပ်ငန်းဆောင်တာ တွေကို လုပ်ဆောင်နိုင်ပါတယ်။
 
 <!-- If you haven't selected an IDE yet, consider the following options: -->
+
 တကယ်လို့ ဘယ် IDE ကို သုံးရမလည်း ဖြစ်နေရင် အောက်က IDE တွေကို သုံးကြည့်သင့်ပါတယ်။
 
 - [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
 - [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform, paid).
 
 <!-- For Windows, there's also "Visual Studio", not to be confused with "Visual Studio Code". "Visual Studio" is a paid and mighty Windows-only editor, well-suited for the .NET platform. It's also good at JavaScript. There's also a free version [Visual Studio Community](https://www.visualstudio.com/vs/community/). -->
+
 Windows အတွက် ဆိုရင် "Visual Studio" (Visual Studio Code မဟုတ်ပါ) ကိုလည်း သုံးကြည့်သင့်ပါတယ်။ "Visual Studio" ဟာ paid version နဲ့ window မှာပဲ သုံးလို့ရတဲ့ editor တွေဖြစ်ပြီး .Net platform တွေအတွက် ပြည့်စုံအောင် လုပ်ပေးထားပါတယ်။ ဒါအပြင် JavaScript အတွက်လည်း သုံးလို့ရပါတယ်။ သူ့ကို free version အနေနဲ့ [Visual Studio Community](https://www.visualstudio.com/vs/community/) ဆိုပြီး ရှိပါတယ်။
 
 <!-- Many IDEs are paid, but have a trial period. Their cost is usually negligible compared to a qualified developer's salary, so just choose the best one for you. -->
+
 IDE တော်တော်များက paid version တွေဖြစ်ပေမယ့် သူတို့မှာ အစမ်းသုံးခွင့် ကာလ ဆိုပြီး သတ်မှတ်ပေးထားပါတယ်။ သူတို့အတွက်ကျသင့်ငွေဟာ developer တစ်ယောက်ရဲ့လစာနဲ့ တွက်ကြည့်လိုက်ရင် သိပ်မသိသာတာကြောင့် ကိုယ်အတွက် အကောင်းဆုံးကို ရွေးချယ်ပြီး သုံးနိုင်ပါတယ်။
 
 ## Lightweight editors
 
 <!-- "Lightweight editors" are not as powerful as IDEs, but they're fast, elegant and simple. -->
+
 "Lightweight editors" တွေဟာ IDE တွေလောက် feature အစုံအလင်မပါပေးမယ့်လည်း သူတို့ဟာ မြန်မြန်ဆန်ဆန် အလုပ်လုပ်နိုင်ခြင်း ၊ အထာကျတဲ့ ပုံစံတွေရှိခြင်း နဲ့ ရိုးရှင်းကျပါတယ်။
 
 <!-- They are mainly used to open and edit a file instantly. -->
+
 သူတို့ကို များသောအားဖြင့် file တစ်ခုကို ချက်ခြင်းဖွင့် ပြီး ချက်ချင်း ပြင် ဖို့အတွက် သုံးကျပါတယ်။
 
 <!-- The main difference between a "lightweight editor" and an "IDE" is that an IDE works on a project-level, so it loads much more data on start, analyzes the project structure if needed and so on. A lightweight editor is much faster if we need only one file. -->
+
 "lightweight editor" နဲ့ "IDE" မှာ အဓိက မတူတဲ့ အချက်ကတော့ IDE တွေဟာ project အဆင့်မှာ အလုပ်လုပ်ပါတယ် ဆိုလိုချင်တာက project တစ်ခုကို စ ဖွင့်လိုက်တာနဲ့ file တွေအများကြီးကို စွဲတင်ရလို့ data တွေ အများကြီးလိုပါတယ်။ ဒါအပြင် လိုအပ်လာရင် project ရဲ့ ပုံစံကို analyst လုပ်ပေးတာ စသည်ဖြင့် လုပ်ပေးပါတယ်။ lightweight editor ကတော့ file တစ်ခုတည်းကို ပဲ ပြင်ချင်တာမျိုး ဖြစ်တဲ့အတွက် ပိုပြီးတော့ မြန်ပါတယ်။
 
 <!-- In practice, lightweight editors may have a lot of plugins including directory-level syntax analyzers and autocompleters, so there's no strict border between a lightweight editor and an IDE. -->
-တကယ်တန်းတော့ lightweight editors တွေမှာလည်း plugins တွေ အများကြီး ရှိပါတယ်။ ထို plugins တွေက IDE လိုပဲ syntex တွေကို analyst လုပ်ပေးတာ ၊ autocomplete လုပ်ပေးတာ စသည်ဖြင့်လုပ်ပေးနိုင်ပါတယ်။ ဒါကြောင့် lightweight editor နဲ့ IDE တွေမှာ လုံးဝ ကွဲပြားခြားနားတဲ့ အရာတော့မရှိပါဘူး။
 
+တကယ်တန်းတော့ lightweight editors တွေမှာလည်း plugins တွေ အများကြီး ရှိပါတယ်။ ထို plugins တွေက IDE လိုပဲ syntex တွေကို analyst လုပ်ပေးတာ ၊ autocomplete လုပ်ပေးတာ စသည်ဖြင့်လုပ်ပေးနိုင်ပါတယ်။ ဒါကြောင့် lightweight editor နဲ့ IDE တွေမှာ လုံးဝ ကွဲပြားခြားနားတဲ့ အရာတော့မရှိပါဘူး။
 
 <!-- The following options deserve your attention: -->
+
 အောက်ဟာ lightweight editor တွေကို တစ်ချက်လေ့လာကြည့်သင့်ပါတယ်။
 
 - [Atom](https://atom.io/) (cross-platform, free).
@@ -51,13 +62,17 @@ IDE တော်တော်များက paid version တွေဖြစ်
 - [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) သူတို့ကလည်း ဘယ်လိုသုံးရမလည်းဆိုတာ သိရင် တော်တော်မိုက်ပါတယ်။
 
 <!-- ## Let's not argue -->
+
 ## အရမ်းကြီး မတွေးပါနဲ့
 
 <!-- The editors in the lists above are those that either I or my friends whom I consider good developers have been using for a long time and are happy with. -->
+
 အပေါ်မှာ ပေးထားတဲ့ စာရင်းတွေဟာ ကျွန်တော်နဲ့ ကျွန်တော့်သူငယ်ချင်း (ငဂျွတ်) တွေ သုံးနေတာ ကြာပါပြီ။
 
 <!-- There are other great editors in our big world. Please choose the one you like the most. -->
+
 တခြား ကောင်းတဲ့ editors တွေလည်း အများကြီးရှိပါတယ်။ ဒါကြောင့် သင့် အကြိုက်ဆုံးဟာကို ပဲ​ရွေးလိုက်ပါ။
 
 <!-- The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences. -->
+
 Editor တစ်ခုကို ရွေးချယ်ရတာလည်း တစ်ခြား tool တွေကို ရွေးရသလိုပါပဲ ၊​ တစ်ကိုယ်ရည် ကြိုက်တဲ့ feature တွေ အလေ့အကျင့် တွေ နဲ့ project တွေရဲ့ requirement တွေ​အပေါ်မှာ မူတည်ပါတယ်။