Comments #20

ghost · 2019-08-07T17:30:24Z

No description provided.

lighthousand · 2019-08-08T06:41:00Z

1-js/03-code-quality/03-comments/article.md


-We normally use them to describe how and why the code works.
+Noi le folosim în mod obișnuit pentru a descrie cum și de ce codul funcționează. 


Grammar suggestion : "de ce codul funcționează" -> "de ce funcționează codul"

lighthousand · 2019-08-08T06:42:12Z

1-js/03-code-quality/03-comments/article.md


-Novices tend to use comments to explain "what is going on in the code". Like this:
+Începătorii tind să utilizeze comentariile pentru a explica "ce se întâmplă în cod". Ceva de genul: 


Grammar suggestion : "Ceva de genul" -> "Ceva de genul ăsta"

lighthousand · 2019-08-09T12:04:26Z

1-js/03-code-quality/03-comments/article.md

@@ -65,21 +63,21 @@ function isPrime(n) {
 }
 ```

-Now we can understand the code easily. The function itself becomes the comment. Such code is called *self-descriptive*.
+Acum putem înțelege codul mult mai ușor. Funcția în sine a devenit comentariul. Acest tip de cod se numește *autodescriptiv*.


Grammar suggestion : "Funcția în sine" -> "Funcția însăși"

lighthousand · 2019-08-09T12:07:06Z

1-js/03-code-quality/03-comments/article.md

@@ -89,8 +87,7 @@ for(let t = 0; t < 3; t++) {

 // ...
 ```
-
-Then it might be a better variant to refactor it into functions like:
+O variantă mai bună ar fi să îl separi în funcții precum:


Grammar suggestion:
"O variantă mai bună ar fi să îl separi în funcții precum:"
->
"Atunci ar putea exista o variantă mai bune de a-l refactoriza în funcții, precum:

lighthousand · 2019-08-09T12:08:21Z

1-js/03-code-quality/03-comments/article.md

@@ -111,70 +108,70 @@ function addJuice(container) {
 }
 ```

-Once again, functions themselves tell what's going on. There's nothing to comment. And also the code structure is better when split. It's clear what every function does, what it takes and what it returns.
+Încă o dată, însuși funcțiile ne spun ce se întâmplă. Nu e nimic de comentat. De asemenea, structura codului este mai bună când este împărțită. Este clar ce face fiecare funcție, ce primește și ce returnează. 


Grammar suggestion: "însuși" ->"însăși"

lighthousand · 2019-08-09T12:10:56Z

1-js/03-code-quality/03-comments/article.md


-In reality, we can't totally avoid "explanatory" comments. There are complex algorithms. And there are smart "tweaks" for purposes of optimization. But generally we should try to keep the code simple and self-descriptive.
+În realitate, nu putem evita în totalitate comentariile "explicative". Există algoritmi complecși. Și există și "încercări" deștepte cu scopul optimizării. Dar în general ar trebui să încercăm să păstrăm codul simplu și autodescriptiv.


Grammar suggestion: "încercări" -> "ajustări"

lighthousand · 2019-08-09T12:13:51Z

1-js/03-code-quality/03-comments/article.md

-Describe the architecture
-: Provide a high-level overview of components, how they interact, what's the control flow in various situations... In short -- the bird's eye view of the code. There's a special diagram language [UML](http://wikipedia.org/wiki/Unified_Modeling_Language) for high-level architecture diagrams. Definitely worth studying.
+Descrierea arhitecturii
+: Oferă o vedere de ansamblu asupra componentelor, cum interacționează, care este ordinea de control în diverse situații... Pe scurt -- ochiul de vultur al codului. Există o diagramă specială a limbajului [UML](https://ro.wikipedia.org/wiki/Unified_Modeling_Language) pentru diagrame de nivel înalt. Se merită studiul acestora.


Grammar suggestions:
"diagramă specială a limbajului" -> "limbaj-diagramă special"
"Se merită studiul acestora" -> "Cu siguranță merită studiate"

lighthousand · 2019-08-09T12:15:54Z

1-js/03-code-quality/03-comments/article.md

-Document a function usage
-: There's a special syntax [JSDoc](http://en.wikipedia.org/wiki/JSDoc) to document a function: usage, parameters, returned value.
+Documentarea utilizării unei funcții
+: Există o sintaxă specială [JSDoc](http://en.wikipedia.org/wiki/JSDoc) pentru a scrie documentația unei funcții: utilizare, parametri, valoare returnată.


Grammar suggestion: "pentru a scrie documentația" -> "pentru a documenta"

lighthousand · 2019-08-09T12:17:06Z

1-js/03-code-quality/03-comments/article.md

    ```js
    /**
-     * Returns x raised to the n-th power.
+     * Returnează x șa puterea n.


Typo fix: "șa puterea n" -> "la puterea n"

lighthousand · 2019-08-09T12:18:35Z

1-js/03-code-quality/03-comments/article.md

-
-    If there are many ways to solve the task, why this one? Especially when it's not the most obvious one.
+
+    Apropo, multe editoare precum [WebStorm](https://www.jetbrains.com/webstorm/) le pot înțelege la fel de bine și să le folosească pentru a asigura autocompletare și verificărri automate ale codului.


Typo fix: "verificărri" -> "verificări"

lighthousand · 2019-08-09T12:21:36Z

1-js/03-code-quality/03-comments/article.md

+    Fără asemenea comentarii următoarea situație este posibilă:
+    1. Tu (sau colegul tău) deschizi codul scris acum ceva timp, și vezi că este "suboptimizat".
+    2. Te gândești: "Ce stupid am fost atunci, și cât de deștept sunt acum", și rescrii codul folosind varianta "mult mai evidentă și corectă".
+    3. ...Impulsul de a rescrie codul a fost bun. Dar în continuarea dezvoltării observi că "cea mai evidentă soluție" este actualmente insuficientă. Îți amintești cu greu de ce, deoarece ai testat-o acum mult timp. Te întorci la varianta corectă, dar timpul a fost pierdut.


Grammar suggestion: "actualmente" -> "defapt"

lighthousand · 2019-08-09T12:24:02Z

1-js/03-code-quality/03-comments/article.md


-Any subtle features of the code? Where they are used?
-: If the code has anything subtle and counter-intuitive, it's definitely worth commenting.
+Orice caracteristică subtilă a codului? Unde este folosită?


Grammar suggestion:
" Orice caracteristică subtilă a codului ? Unde este folosită ?"
->
"Orice caracteristici folosite ale codului ? Unde sunt folosite ?"

lighthousand · 2019-08-09T12:25:32Z

1-js/03-code-quality/03-comments/article.md

-Any subtle features of the code? Where they are used?
-: If the code has anything subtle and counter-intuitive, it's definitely worth commenting.
+Orice caracteristică subtilă a codului? Unde este folosită?
+: În cazul în care codul are ceva subtil sau neintuitiv, atunci este necesară comentarea.


Grammar suggestion: "neintuitiv" -> "contraintuitiv"

lighthousand

Modifications needed

javascript-translate-bot · 2019-08-09T12:27:14Z

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

ghost · 2019-08-09T14:30:08Z

/done

javascript-translate-bot · 2019-08-14T07:59:00Z

Thank you 💖 I updated the Progress Issue #1 🎉 🎉 🎉

Comments

ef12705

javascript-translate-bot added the review needed label Aug 7, 2019

javascript-translate-bot requested a review from a team August 7, 2019 17:30

iliakan mentioned this pull request Aug 7, 2019

Romanian Translation Progress #1

Open

lighthousand reviewed Aug 8, 2019

View reviewed changes

lighthousand reviewed Aug 9, 2019

View reviewed changes

lighthousand requested changes Aug 9, 2019

View reviewed changes

javascript-translate-bot added changes requested and removed review needed labels Aug 9, 2019

Update article.md

eb42c85

javascript-translate-bot added review needed and removed changes requested labels Aug 9, 2019

javascript-translate-bot requested a review from a team August 9, 2019 14:30

lighthousand approved these changes Aug 14, 2019

View reviewed changes

javascript-translate-bot added needs +1 and removed review needed labels Aug 14, 2019

lighthousand merged commit 712a32a into javascript-tutorial:master Aug 14, 2019

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments #20

Comments #20

ghost commented Aug 7, 2019

lighthousand Aug 8, 2019

lighthousand Aug 8, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019 •

edited

Loading

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand Aug 9, 2019

lighthousand left a comment

javascript-translate-bot commented Aug 9, 2019

ghost commented Aug 9, 2019

javascript-translate-bot commented Aug 14, 2019


		We normally use them to describe how and why the code works.
		Noi le folosim în mod obișnuit pentru a descrie cum și de ce codul funcționează.


		Novices tend to use comments to explain "what is going on in the code". Like this:
		Începătorii tind să utilizeze comentariile pentru a explica "ce se întâmplă în cod". Ceva de genul:


		In reality, we can't totally avoid "explanatory" comments. There are complex algorithms. And there are smart "tweaks" for purposes of optimization. But generally we should try to keep the code simple and self-descriptive.
		În realitate, nu putem evita în totalitate comentariile "explicative". Există algoritmi complecși. Și există și "încercări" deștepte cu scopul optimizării. Dar în general ar trebui să încercăm să păstrăm codul simplu și autodescriptiv.


		If there are many ways to solve the task, why this one? Especially when it's not the most obvious one.

		Apropo, multe editoare precum [WebStorm](https://www.jetbrains.com/webstorm/) le pot înțelege la fel de bine și să le folosească pentru a asigura autocompletare și verificărri automate ale codului.

Comments #20

Comments #20

Conversation

ghost commented Aug 7, 2019

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lighthousand Aug 9, 2019 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lighthousand left a comment

Choose a reason for hiding this comment

javascript-translate-bot commented Aug 9, 2019

ghost commented Aug 9, 2019

javascript-translate-bot commented Aug 14, 2019

lighthousand Aug 9, 2019 •

edited

Loading