From c15eec6e9d536e12700f1b141a08d071eb949e92 Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Thu, 14 Feb 2019 13:35:07 +0000 Subject: [PATCH 1/4] housekeeping: Adjusted README, versioned Glossary + Style Guide This is just to tidy up things a bit. --- GLOSSARY.md | 28 ++++++++++++++++++++++++++++ README.md | 18 ++++++++++++------ STYLE_GUIDE.md | 2 ++ 3 files changed, 42 insertions(+), 6 deletions(-) create mode 100644 GLOSSARY.md create mode 100644 STYLE_GUIDE.md diff --git a/GLOSSARY.md b/GLOSSARY.md new file mode 100644 index 000000000..5fedc343c --- /dev/null +++ b/GLOSSARY.md @@ -0,0 +1,28 @@ +# Glossary + +Glossary of the translations of technical and React-specific terms. + +## Untranslatable terms +- footer +- bug +- browser +- client +- server + +# Common Translations + +Suggestion on words and terms: + +| Original word/term | Suggestion | +| ------------------ | ---------- | +| render | renderizzare (verbo), renderizzato (nome) | +| React component class | classe componente React | +| React component type | tipo componente React | + +## Problematic terms + +Here's a list of terms that require discussion/agreement, with a link to the issue. + +- `to render` (#7) +- `React component class` (#7) +- `React component type` (#7) \ No newline at end of file diff --git a/README.md b/README.md index 3044c0d66..1f7853ad9 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,22 @@ -# reactjs.org +# it.reactjs.org 🇮🇹 -This repo contains the source code and documentation powering [reactjs.org](https://reactjs.org/). +This repo contains the source code and documentation powering [it.reactjs.org](https://it.reactjs.org/). + + +## Before we start, some useful links: + +- [Glossary](GLOSSARY.md) +- [Style Guide](STYLE_GUIDE.md) ## Getting started ### Prerequisites 1. Git -1. Node: any 8.x version starting with 8.4.0 or greater -1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/) -1. A fork of the repo (for any contributions) -1. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine +2. Node: any 8.x version starting with 8.4.0 or greater +3. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/) +4. A fork of the repo (for any contributions) +5. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine ### Installation diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md new file mode 100644 index 000000000..bf0566699 --- /dev/null +++ b/STYLE_GUIDE.md @@ -0,0 +1,2 @@ + +👷 \ No newline at end of file From f2ba48f2368381a22a84f6183145f342e69fa1bc Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Thu, 14 Feb 2019 13:39:43 +0000 Subject: [PATCH 2/4] fix --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1f7853ad9..ed7b3c320 100644 --- a/README.md +++ b/README.md @@ -13,10 +13,10 @@ This repo contains the source code and documentation powering [it.reactjs.org](h ### Prerequisites 1. Git -2. Node: any 8.x version starting with 8.4.0 or greater -3. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/) -4. A fork of the repo (for any contributions) -5. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine +1. Node: any 8.x version starting with 8.4.0 or greater +1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/) +1. A fork of the repo (for any contributions) +1. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine ### Installation From 55a20d2a50dd65d8974291a74e4ff5350e136150 Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Thu, 14 Feb 2019 14:56:26 +0000 Subject: [PATCH 3/4] refactor --- GLOSSARY.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index 5fedc343c..4eabb965a 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -13,11 +13,13 @@ Glossary of the translations of technical and React-specific terms. Suggestion on words and terms: -| Original word/term | Suggestion | +| Original word/term | Suggestion | | ------------------ | ---------- | +| refactor | rifattorizzare | +| refactoring | rifattorizzazione | | render | renderizzare (verbo), renderizzato (nome) | -| React component class | classe componente React | -| React component type | tipo componente React | +| React component class | classe componente React | +| React component type | tipo componente React | ## Problematic terms @@ -25,4 +27,5 @@ Here's a list of terms that require discussion/agreement, with a link to the iss - `to render` (#7) - `React component class` (#7) -- `React component type` (#7) \ No newline at end of file +- `React component type` (#7) +- `refactor` (#9) \ No newline at end of file From 8793234f28ecc1ccf6d4e0d56bfe16efd9229f5c Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Thu, 14 Feb 2019 18:31:08 +0000 Subject: [PATCH 4/4] glossary: adding terms --- GLOSSARY.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index 4eabb965a..26fdf946b 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -28,4 +28,6 @@ Here's a list of terms that require discussion/agreement, with a link to the iss - `to render` (#7) - `React component class` (#7) - `React component type` (#7) -- `refactor` (#9) \ No newline at end of file +- `refactor` (#9) +- `event handler` (#10) +- `event listener` (#10) \ No newline at end of file