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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all 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.
ეს წიგნი არის "ტუტორიალი". მისი მიზანია, რომ დაგეხმაროს ენის თანდათანობით სწავლის პროცესში, მაგრამ როგორც კი შეისწავლი საფუძვლებს აუცილებლად დაგჭირდება სხვა წყაროებიც

## Specification
## სპეციფიკაციები

**The ECMA-262 specification** contains the most in-depth, detailed and formalized information about JavaScript. It defines the language.
**ECMA-262 - ის სპეციფიკაციები** შეიცავს ყველაზე ღრმა, დეტალურ და ფორმირებულ ინფორმაციას 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.
მაგრამ ასეთი ფორმირებული(ოფიციალური) ინფორმაცია ძნელი გადაგებია დასაწყისში. ასე, რომ თუ გჭირდება ინფორმაციის უფრო სანდო წყარო ენის დეტალებისთვის განმარტებები არის შესაფერისი ადგილი. მაგრამ არა ყოველდღიური გამოყენებისთვის.

The latest 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>.
ახალი bleeding-edge - ის ფუნქციების შესახებ, რომ წაიკითხოთ, იმათ ჩათვლით, რომლებიც არიან "almost standard" (ასე ვთქვათ "stage 3"), იხ. შემოთავაზებები <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.
ასევე, თუ შენ მუშაობ ბრაუზერისთვის , ამისთვის არსებობს სხვა სპეციფიკაციები, რომელსაც განვიხილავთ ტუტორიალის მეორე ნაწილში [second part](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]" თქვენს შეკითხვაში, მაგ. <https://google.com/search?q=MDN+parseInt> რომ მოვძებნოთ `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** – Microsoft - ის სახელმძღვანელო უამრავი ინფორმაციით, მათ შორის JavaScript - ზე (რომელიც ხშირად მოხსენიებულია როგორც JScript). თუ ვინმეს სჭირდება რაიმე სპეციფიკური Internet Explorer - თან , უკეთესია იხილოს: <http://msdn.microsoft.com/>.

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.
JavaScript განვითარებადი ენაა, სისტემატურად ემატება ახალი ფუნქციები.

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> - თითოეულ ფუნქციას აქვს მხარდაწერის ცხრილი, მაგ. რომ ვნახოთ რომელი ძრავის მხარდაჭერა აქვს თანამედროვე cryptography ფუნქციას: <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.
გთხოვთ დაიმახსოვრეთ ისინი (ან ეს გვერდი) იმ შემთხვევისთვის თუ გინდათ უფრო ღრმა ინფორმაცია, რომელიმე კონკრეტულ ფუნქციაზე.