Skip to content

Manuals and specifications #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Oct 15, 2019
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 21 additions & 21 deletions 1-js/01-getting-started/2-manuals-specifications/article.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,42 @@

# 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.
এই বইটি একটি *টিউটরিয়াল।* এর উদ্দেশ্য হল আপনাকে আস্তে আস্তে ভাষাটি শিখতে সাহায্য করা। কিন্তু আপনি ব্যাসিকগুলো একবার মোটামুটি শিখে গেলে অন্য আরো সোর্সের প্রয়োজন পড়বে।
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

সোর্স থেকে উৎস শব্দটি ব্যবহার করা উচিত হবে বলে মনে হয়।

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

কিন্তু সেন্টেন্সটা পড়তে অড লাগে

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

সোর্স বা উৎস দুইটায় বাদ দিয়ে রিসোর্স ব্যাবহার করতে পারেন।


## 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.
[ECMA-262 স্পেসিফিকেশন](https://www.ecma-international.org/publications/standards/Ecma-262.htm)-এ জাভাস্ক্রিপ্টের সবচেয়ে গভীর, বিস্তারিত ও ফর্মাল তথ্য আছে। এটাই ভাষাটিকে সংজ্ঞায়িত করে।
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sjsakib ফর্মাল এর কিছু ভালো বাংলা প্রতিশব্দ আছে। সেগুলি ব্যবহার করলে আমার মনে হয় আরও ভালো শোনাবে। যেমনঃ বিধিবদ্ধ অথবা আরও সহজ শব্দ আছে সাজানো

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"স্পেসিফিকেশন এ" -> "স্পেসিফিকেশনে" লিখলে ভালো দেখাবে।

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sjsakib ফর্মাল এর কিছু ভালো বাংলা প্রতিশব্দ আছে। সেগুলি ব্যবহার করলে আমার মনে হয় আরও ভালো শোনাবে। যেমনঃ বিধিবদ্ধ অথবা আরও সহজ শব্দ আছে সাজানো

আনুষ্ঠানিক কেমন?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

চলে


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.
কিন্তু এত বেশি ফর্মাল হওয়ার কারণে প্রথমদিকে এটি বুঝতে বেশ অসুবিধা হয়। তাই আপনার যদি ভাষার বিস্তারিত ব্যাপারগুলোতে সবচেয়ে বিশ্বস্ত সোর্সের প্রয়োজন হয়, তাহলে এই স্পেসিফিকেশনটি দেখতে হবে। কিন্তু এটি দৈনন্দিন ব্যবহারের জন্য নয়।

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>.
"প্রায় স্ট্যান্ডার্ড" (তথাকথিত "স্টেজ-৩") ফিচারগুলোসহ একেবারে নতুন ও প্রান্তীয় ফিচারগুলোর ব্যাপারে পড়তে এখানকার প্রস্তাবগুলো দেখুন: <https://github.com/tc39/proposals>

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.
আর আপনি যদি ব্রাউজারের জন্য ডেভেলাপ করেন তাহলে আরো স্পেকস আছে যা এই বইয়ের [দ্বিতীয় অংশে](info:browser-environment) কভার করা করা হয়েছে।

## Manuals
## ম্যানুয়াল

- **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.
- **MDN (Mozilla) 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.
যদিও বেশিরভাগ সময় ইন্টার্নেটে সার্চ করলেই ভাল হয়। সার্চ করার সময় "MDN [term]" ব্যবহার করুন। যেমন `parseInt` ফাংশনের জন্য সার্চ করতে <https://google.com/search?q=MDN+parseInt>


- **MSDN** – Microsoft manual with a lot of information, including JavaScript (often referred to as JScript). If one needs something specific to Internet Explorer, better go there: <http://msdn.microsoft.com/>.
- **MSDN** – জাভাস্ক্রিপ্টসহ অনেক তথ্যসমৃদ্ধ মাইক্রোসফ্টের ম্যানুয়াল (ওরা অনেকসয় বলে JScript)। যদি নির্দিষ্টভাবে ইন্টার্নেট এক্সপ্লোরারের ব্যাপারে কিছু লাগে তাহলে ঐখানে যাওয়াই ভাল: <http://msdn.microsoft.com/>.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ইন্টার্নেট - বানান ইন্টারনেট হবে।

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • MSDN – জাভাস্ক্রিপ্টের অনেক তথ্যসমৃদ্ধ মাইক্রোসফটের ম্যানুয়াল (এটিকে JScript নামেও ডাকা হয়ে থাকে)। যদি নির্দিষ্টভাবে ইন্টারনেট এক্সপ্লোরারের ব্যাপারে কোন কিছু জানার থাকে তাহলে ঐখানে যাওয়াই ভাল: http://msdn.microsoft.com/.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • MSDN – জাভাস্ক্রিপ্টের অনেক তথ্যসমৃদ্ধ মাইক্রোসফটের ম্যানুয়াল (এটিকে JScript নামেও ডাকা হয়ে থাকে)। যদি নির্দিষ্টভাবে ইন্টারনেট এক্সপ্লোরারের ব্যাপারে কোন কিছু জানার থাকে তাহলে ঐখানে যাওয়াই ভাল: http://msdn.microsoft.com/.

অর্থ বদলে যায়। প্রথমত এখানে বলা হয়েছে MSDN এ জাভাস্ক্রিপ্ট ছাড়াও আরো অনেক তথ্য আছে। দ্বিতীয়ত মাইক্রোসফ্ট ছাড়া জাভাস্ক্রিপ্টকে আর কেউ JScript বলে না।

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

হুম। একমত। এগিয়ে যান।


Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
আর "RegExp MSDN" অথবা "RegExp MSDN jscript" আকারেও ইন্টার্নেট সার্চ করতে পারেন।

## Compatibility tables
## কম্প্যাটিবিলিটি টেবিল

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.
- <http://caniuse.com> - ফিচারভিত্তিক সাপোর্টের টেবিল। যেমন- কোন ইন্জিনগুলো অধুনিক ক্রিপ্টোগ্রাফি ফাংশনগুলো সাপোর্ট করে দেখতে: <http://caniuse.com/#feat=cryptography>.
- <https://kangax.github.io/compat-table> - ভাষার ফিচারসমূহ ও কোন ইন্জিনগুলো সেগুলো সাপোর্ট করে বা করে না তার উপর একটি টেবিল।

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.
দয়া করে এগুলো মনে রাখবেন (অথবা এই পেজটি)। যখন কোন একটি নির্দিষ্ট ফিচারের ব্যাপারে বিস্তারিত তথ্য লাগবে তখন এগুলো কাজে আসবে।