Skip to content

Commit

Permalink
Merge branch 'master' into patch-1
Browse files Browse the repository at this point in the history
  • Loading branch information
leobalter committed May 14, 2021
2 parents 70b3f7e + 846287a commit d2a7ac4
Show file tree
Hide file tree
Showing 20 changed files with 2,750 additions and 51 deletions.
1 change: 1 addition & 0 deletions contributors.md
Expand Up @@ -30,3 +30,4 @@
* Calvin Jeng [@l0ckys](http://twitter.com/l0ckys), [github](https://github.com/lockys)
* Richard Gibson [@gibson042](http://twitter.com/gibson042), [github](https://github.com/gibson042)
* Fesuy [github](https://github.com/fesuydev)
* Stephane Moreau [github](https://github.com/stmoreau)
11 changes: 7 additions & 4 deletions readme.md
Expand Up @@ -16,7 +16,7 @@
* Leo Beto Souza [@leobetosouza](http://twitter.com/leobetosouza), [github](https://github.com/leobetosouza)
* Ryuichi Okumura [@okuryu](http://twitter.com/okuryu), [github](https://github.com/okuryu)
* Pascal Precht [@PascalPrecht](http://twitter.com/PascalPrecht), [github](https://github.com/pascalprecht)
* EngForDev [engfordev](http://www.opentutorials.org/course/167/1363) - Hwan Min Hong / MinTaek Kwon [@leoinsight](http://twitter.com/leoinsight) / Tw Shim [@marocchino](http://twitter.com/marocchino), [github](https://github.com/marocchino) / Nassol Kim [@nassol99](http://twitter.com/nassol99), [github](https://github.com/nassol) / Juntai Park [@rkJun](http://twitter.com/rkJun), [github](https://github.com/rkJun) / Minkyu Shim / Gangmin Won / Justin Yoo [@justinchronicle](http://twitter.com/justinchronicle) / Daeyup Lee
* EngForDev [engfordev](https://opentutorials.org/course/245/1788) - Hwan Min Hong / MinTaek Kwon [@leoinsight](http://twitter.com/leoinsight) / Tw Shim [@marocchino](http://twitter.com/marocchino), [github](https://github.com/marocchino) / Nassol Kim [@nassol99](http://twitter.com/nassol99), [github](https://github.com/nassol) / Juntai Park [@rkJun](http://twitter.com/rkJun), [github](https://github.com/rkJun) / Minkyu Shim / Gangmin Won / Justin Yoo [@justinchronicle](http://twitter.com/justinchronicle) / Daeyup Lee
* Marco Trulla [@marcotrulla](http://twitter.com/marcotrulla), [github](https://github.com/Ragnarokkr)
* Alex Navasardyan [@alexnavasardyan](http://twitter.com/alexnavasardyan), [github](https://github.com/2k00l)
* Mihai Paun [@mihaipaun](http://twitter.com/mihaipaun), [github](https://github.com/mihaipaun)
Expand All @@ -35,6 +35,7 @@
* Hao-Wei Jeng [@l0ckys](http://twitter.com/l0ckys), [github](https://github.com/lockys)
* Richard Gibson [@gibson042](http://twitter.com/gibson042), [github](https://github.com/gibson042)
* Fesuy [github](https://github.com/fesuydev)
* Stephane Moreau [github](https://github.com/stmoreau)


## All code in any code-base should look like a single person typed it, no matter how many people contributed.
Expand Down Expand Up @@ -69,12 +70,13 @@
* [Serbian - latin alphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/sr_SR)
* [繁體中文](https://github.com/rwaldron/idiomatic.js/tree/master/translations/zh_TW)
* [Indonesian](https://github.com/rwaldron/idiomatic.js/tree/master/translations/id_ID)
* [Greek](https://github.com/rwaldron/idiomatic.js/tree/master/translations/gr_GR)

## Important, Non-Idiomatic Stuff:

### Code Quality Tools, Resources & References

* [JavaScript Plugin](http://docs.codehaus.org/display/SONAR/JavaScript+Plugin) for [Sonar](http://www.sonarsource.org/)
* [SonarQube](https://www.sonarqube.org/)
* [Plato](https://github.com/es-analysis/plato)
* [jsPerf](http://jsperf.com/)
* [jsFiddle](http://jsfiddle.net/)
Expand All @@ -96,7 +98,7 @@

The following should be considered 1) incomplete, and 2) *REQUIRED READING*. I don't always agree with the style written by the authors below, but one thing is certain: They are consistent. Furthermore, these are authorities on the language.

* [Baseline For Front End Developers: 2015](http://rmurphey.com/blog/2015/03/23/a-baseline-for-front-end-developers-2015/)
* [Baseline For Front End Developers: 2015](https://rmurphey.com/posts/a-baseline-for-front-end-developers-2015/)
* [Eloquent JavaScript](http://eloquentjavascript.net/)
* [JavaScript, JavaScript](http://javascriptweblog.wordpress.com/)
* [Adventures in JavaScript Development](http://rmurphey.com/)
Expand Down Expand Up @@ -127,6 +129,7 @@ Projects _must_ include some form of unit, reference, implementation or function
* [Buster.js](http://busterjs.org/)
* [Sinon.js](http://sinonjs.org/)
* [Tape](https://github.com/substack/tape)
* [Jest](https://facebook.github.io/jest/)

## Table of Contents

Expand Down Expand Up @@ -1300,7 +1303,7 @@ The following sections outline a _reasonable_ style guide for modern JavaScript

#### “Everything is Permitted: Extending Built-ins” by Andrew Dupont (JSConf2011, Portland, Oregon)

http://www.everytalk.tv/talks/441-JSConf-Everything-is-Permitted-Extending-Built-ins
https://www.youtube.com/watch?v=xL3xCO7CLNM


9. <a name="comments">Comments</a>
Expand Down
4 changes: 3 additions & 1 deletion translations/de_DE/readme.md
Expand Up @@ -25,6 +25,7 @@
* Miloš Gavrilović [@gavrisimo](http://twitter.com/gavrisimo), [github](https://github.com/gavrisimo)
* Duc Nguyen [@ducntq](https://twitter.com/ducntq), [github](https://github.com/ducntq)
* James Young [@jamsyoung](http://twitter.com/jamsyoung), [github](https://github.com/jamsyoung)
* Stephane Moreau [github](https://github.com/stmoreau)


## Code sollte grundsätzlich so aussehen, als wäre er von einer einzigen Person geschrieben worden, völlig egal, wie viele letztlich daran gearbeitet haben.
Expand All @@ -51,6 +52,7 @@
* [简体中文](https://github.com/rwldrn/idiomatic.js/tree/master/translations/zh_CN)
* [Serbian - cyrilic alphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/ср_СР)
* [Serbian - latin aplphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/sr_SR)
* [Greek](https://github.com/rwaldron/idiomatic.js/tree/master/translations/gr_GR)

## Wichtiger, nicht-idiomatischer Kram:

Expand Down Expand Up @@ -973,7 +975,7 @@ Die folgenden Bereiche zeigen einen vertretbaren Style Guide für moderne JavaSc

#### “Everything is Permitted: Extending Built-ins” by Andrew Dupont (JSConf2011, Portland, Oregon)

http://www.everytalk.tv/talks/441-JSConf-Everything-is-Permitted-Extending-Built-ins
https://www.youtube.com/watch?v=xL3xCO7CLNM


9. <a name="comments">Kommentare</a>
Expand Down
6 changes: 4 additions & 2 deletions translations/es_ES/readme.md
Expand Up @@ -31,6 +31,7 @@
* Yotam Ofek [@yotamofek](https://twitter.com/yotamofek) [github](https://github.com/yotamofek)
* Duc Nguyen [@ducntq](https://twitter.com/ducntq), [github](https://github.com/ducntq)
* James Young [@jamsyoung](http://twitter.com/jamsyoung), [github](https://github.com/jamsyoung)
* Stephane Moreau [github](https://github.com/stmoreau)



Expand Down Expand Up @@ -64,6 +65,7 @@
* [简体中文](https://github.com/rwldrn/idiomatic.js/tree/master/translations/zh_CN)
* [Serbian - cyrilic alphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/ср_СР)
* [Serbian - latin aplphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/sr_SR)
* [Greek](https://github.com/rwaldron/idiomatic.js/tree/master/translations/gr_GR)


## Cosas importantes, no relacionadas directamente con el JS idiomático:
Expand Down Expand Up @@ -970,7 +972,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para un desar

```

B. Caras de `this`
B. Caras de `this`

Mas allá de los generalmente bien conocidos casos de uso de `call` y `apply`, siempre preferir `.bind( this )` o equivalente, para crear definiciones de `BoundFunction` para invocar más tarde. Sólo recurrir a alias cuando no hay disponible una opción preferible.

Expand Down Expand Up @@ -1278,7 +1280,7 @@ B. Caras de `this`

#### “Everything is Permitted: Extending Built-ins” by Andrew Dupont (JSConf2011, Portland, Oregon) - recomendada!

http://www.everytalk.tv/talks/441-JSConf-Everything-is-Permitted-Extending-Built-ins
[Andrew Dupont: Everything is Permitted: Extending Built-ins](https://www.youtube.com/watch?v=xL3xCO7CLNM)


9. <a name="comments">Comentarios</a>
Expand Down
25 changes: 14 additions & 11 deletions translations/fr_FR/readme.md
@@ -1,4 +1,4 @@
# Principe d'écriture d'un code Javascript cohérent et idiomatique
# Principes d'écriture d'un code JavaScript cohérent et idiomatique

## Il s'agit d'un document vivant, les nouvelles idées pour améliorer le code autour de nous sont toujours les bienvenues. Pour contribuer : "fork", "clone", "branch", "commit", "push", "pull request".

Expand All @@ -25,6 +25,7 @@
* Miloš Gavrilović [@gavrisimo](http://twitter.com/gavrisimo), [github](https://github.com/gavrisimo)
* Duc Nguyen [@ducntq](https://twitter.com/ducntq), [github](https://github.com/ducntq)
* James Young [@jamsyoung](http://twitter.com/jamsyoung), [github](https://github.com/jamsyoung)
* Stephane Moreau [github](https://github.com/stmoreau)


## Tout code, peu importe les bases sur lesquelles il est établi, devrait ressembler au code tapé par une seule personne, peu importe le nombre de personnes ayant contribué.
Expand All @@ -50,6 +51,7 @@
* [简体中文](https://github.com/rwldrn/idiomatic.js/tree/master/translations/zh_CN)
* [Serbian - cyrilic alphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/ср_СР)
* [Serbian - latin aplphabet](https://github.com/rwldrn/idiomatic.js/tree/master/translations/sr_SR)
* [Greek](https://github.com/rwaldron/idiomatic.js/tree/master/translations/gr_GR)

## Important, aspect non idiomatique :

Expand Down Expand Up @@ -431,7 +433,7 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve
JavaScript est un langage typé dynamiquement - ce qui peut être votre meilleur ami comme votre pire ennemi : respectez donc les 'types', en appliquant les règles ci-dessus.


3.B Coercion de type
3.B Conversion de type

Considérons les implications de ce qui suit...

Expand All @@ -455,7 +457,8 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve
// "number"
...

// Quelque part plus loin dans votre code, vous devez mettre à jour `foo`
// Quelque part plus loin dans votre code, vous devez mettre
jour `foo`
// avec une nouvelle valeur issue de l'élément 'input'

foo = document.getElementById("foo-input").value;
Expand All @@ -473,7 +476,7 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve

// 3.B.1.2

// Vous pouvez vous prémunir de ce problème en utilisant la coercion de type de l'opérateur unaire + ou - :
// Vous pouvez vous prémunir de ce problème en utilisant la conversion de type avec l'opérateur unaire + ou - :

foo = +document.getElementById("foo-input").value;
^ opérateur unaire + convertissant à sa droite l'opérande en "number"
Expand All @@ -490,7 +493,7 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve
// `important()` sera évalué
```

Voici quelques cas courants de coercion :
Voici quelques cas courants de conversion :


```javascript
Expand Down Expand Up @@ -641,7 +644,7 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve
// Plutôt que d'utiliser l'expression suivante :
if ( foo === false ) ...

// ...utilisez la négation et la coercion de l'évaluation de la vérité :
// ...utilisez la négation et la conversion de l'évaluation de la vérité :
if ( !foo ) ...

// ...Soyez prudent, cela correspondra aux valeurs suivantes : 0, "", null, undefined, NaN
Expand All @@ -654,7 +657,7 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve
// Plutôt que d'utiliser l'expression suivante :
if ( foo === null || foo === undefined ) ...

// ...bénéficiez de la coercion de type ==, comme suit :
// ...bénéficiez de la conversion de type ==, comme suit :
if ( foo == null ) ...

// Souvenez-vous, utiliser == vérifiera une égalité avec `null` et `null` & `undefined`
Expand All @@ -667,16 +670,16 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve
```javascript

// 4.2.1
// Coercion de Type coercion et remarques
// Conversion de type et remarques

Preferez `===` à la place de `==` (à moins que le cas de test ne requiert la perte d'évaluation de type)

=== n'effectue pas de coercion de type, ce qui signifie que :
=== n'effectue pas de conversion de type, ce qui signifie que :

"1" === 1;
// faux

== effectue la coercion de type, ce qui signifie que :
== effectue la conversion de type, ce qui signifie que :

"1" == 1;
// vrai
Expand Down Expand Up @@ -984,7 +987,7 @@ Les sections suivantes décrivent un guide de style _raisonable_ pour tout déve

#### “Everything is Permitted: Extending Built-ins” by Andrew Dupont (JSConf2011, Portland, Oregon)

http://www.everytalk.tv/talks/441-JSConf-Everything-is-Permitted-Extending-Built-ins
https://www.youtube.com/watch?v=xL3xCO7CLNM


9. <a name="comments">Commentaires</a>
Expand Down

0 comments on commit d2a7ac4

Please sign in to comment.