translated article.md

Author: kooshan75

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

@@ -1,41 +1,37 @@
-# 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.
+این کتاب یک راهنما است که به شما کمک می‌کند در نهایت این زبان را بیاموزید. اما وقتی که شما با مفاهیم پایه‌ای آشنا شدید، به منابع دیگر نیاز خواهید داشت.
+## مشخصات (Specification)
 
-## Specification
+**The ECMA-262 specification** شامل عمیق‌ترین، دقیق‌ترین و رسمی‌ترین اطلاعات در جاوا اسکریپت است که زبان را تعریف می‌کند.
 
-**The ECMA-262 specification** contains the most in-depth, detailed and formalized information about JavaScript. It defines the language.
+اما در ابتدا اگر بخواهیم آنقدر رسمی و دقیق باشیم، درک این زبان سخت می‌شود. بنابراین اگر به منبع اطلاعات قابل اعتماد در مورد جزئیات این زبان نیاز دارید، Specification بهترین مکان است. اما برای استفاده‌ی روزانه نیست.
 
-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.
+آخرین نوشته در <https://tc39.es/ecma262/> است.
 
-The latest draft is at <https://tc39.es/ecma262/>.
+برای آگاهی از ویژگی‌های به روز که تقریبا استاندارد هستند، به <https://github.com/tc39/proposals> مراجعه کنید.
 
-To read about new bleeding-edge features, that are "almost standard", see proposals at <https://github.com/tc39/proposals>.
+همینطور اگر به دنبال برنامه‌نویسی مرورگر هستید، به [بخش دوم](info:browser-environment) مراجعه کنید.
+## کتابچه راهنما
 
-Also, if you're in developing for the browser, then there are other specs covered in the [second part](info:browser-environment) of the tutorial.
+**MDN (Mozilla) JavaScript Reference** یک راهنما با مثال‌ها و اطلاعات دیگرست. خوب است که به عمق اطلاعات در مورد توابع زبان و متدها و غیره وارد شوید.
+میتوانید آنرا در <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> پیدا کنید. 
 
-## Manuals
+اگرچه اغلب اوقات بهتر است که در عوض، یک جستجویی در اینترنت بکنید. در عبارت مورد جستجوی خود "MDN [موضوع مورد نظر]" را قرار دهید. مثلا؛ در جستجوی تابع `parseInt`، <https://google.com/search?q=MDN+parseInt>.
 
-- **MDN (Mozilla) JavaScript Reference** is a manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
+- **MSDN**، کتابچه راهنما مایکروسافت با بسیاری اطلاعات که شامل جاوا اسکریپت (که اغلب با اسم JScript آورده شده). اگر کسی به سوالی خاص در Internet Explorer نیاز داشت، بهتر است که به <http://msdn.microsoft.com/> مراجعه کند.
 
-    One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+همینطور میتوانیم جستجوی اینترنتی با عباراتی مثل "RegExp MSDN" یا "RegExp MSDN jscript" را انجام دهیم.
+## پشتیبانی از ویژگی‌ها (Features)
 
-    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.
+جاوا اسکریپت یک زبان برنامه‌نویسیت که به طور منظم به آن خواص جدیدی اضافه می‌شود. 
 
+برای دیدن پشتیبانی مرورگر و بقیه‌ی موتورها این‌ها را ببینید:
 
-- **MSDN** – Microsoft manual with a lot of information, including JavaScript (often referrerd to as JScript). If one needs something specific to Internet Explorer, better go there: <http://msdn.microsoft.com/>.
+- <http://caniuse.com> جدولی بر اساس پشتیبانی خواص. فرضاً برای دیدن اینکه کدام موتورها توابع مدرن  رمزنگاری را پشتیبانی میکند به <http://caniuse.com/#feat=cryptography> مراجعه کنید.
 
-    Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
+- <https://kangax.github.io/compat-table> جدولی با ویژگی‌های زبان و موتورهایی که قابلیت پشتیبانی آنهارا دارند یا ندارند.
 
-## Feature support
+تمام این منابع در توسعه و برنامه‌نویسی‌ در زندگی واقعی مفیدند چراکه بسیاری اطلاعات ارزشمند راجب جزئیات زبان، پشتیبانیشان و غیره را دارند.
 
-JavaScript is a developing language, new features get added regularly.
-
-To see their support among browser-based and other engines, see:
-
-- <http://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <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.
-
-All these resources are useful in real-life development, as they contain valuable information about language details, their support etc.
-
-Please remember them (or this page) for the cases when you need in-depth information about a particular feature.
+این صفحه را وقتی به اطلاعات دقیق یا یک ویژگی خاصی نیاز داشتید به یاد داشته باشید.