diff --git a/docs/i18n/chinese/how-to-work-on-coding-challenges.md b/docs/i18n/chinese/how-to-work-on-coding-challenges.md index af03d7fd4b..36ade2941a 100644 --- a/docs/i18n/chinese/how-to-work-on-coding-challenges.md +++ b/docs/i18n/chinese/how-to-work-on-coding-challenges.md @@ -73,6 +73,10 @@ assert.equal( ); ``` +# --notes-- + +Extra information for a challenge, in markdown + # --seed-- ## --before-user-code-- diff --git a/docs/i18n/espanol/how-to-work-on-coding-challenges.md b/docs/i18n/espanol/how-to-work-on-coding-challenges.md index 6e3cf6c840..4338884d99 100644 --- a/docs/i18n/espanol/how-to-work-on-coding-challenges.md +++ b/docs/i18n/espanol/how-to-work-on-coding-challenges.md @@ -77,6 +77,10 @@ assert.equal( ); ``` +# --notes-- + +Extra information for a challenge, in markdown + # --seed-- ## --before-user-code-- diff --git a/docs/i18n/italian/how-to-work-on-coding-challenges.md b/docs/i18n/italian/how-to-work-on-coding-challenges.md index c90988f549..7993fd7442 100644 --- a/docs/i18n/italian/how-to-work-on-coding-challenges.md +++ b/docs/i18n/italian/how-to-work-on-coding-challenges.md @@ -73,6 +73,10 @@ assert.equal( ); ``` +# --notes-- + +Extra information for a challenge, in markdown + # --seed-- ## --before-user-code-- @@ -89,7 +93,7 @@ Codice eseguito dopo il codice dell'utente, ma prima dei test ## --seed-contents-- -Codice di partenza da far apparire nell'editor. Questa sezione deve contenere solo codice in backtick, come il seguente: +Boilerplate code to render to the editor. This section should only contain code inside backticks, like the following: ```html @@ -114,7 +118,7 @@ console.log('freeCodeCamp is awesome!'); # --solutions-- -Le soluzioni sono usate dai test CI per assicurarsi che i cambiamenti alla sezione hints facciano eseguire i test correttamente +Solutions are used for the CI tests to ensure that changes to the hints will still pass as intended ```js // prima soluzione - il linguaggio deve combaciare con il seed. @@ -134,27 +138,27 @@ Le soluzioni sono usate dai test CI per assicurarsi che i cambiamenti alla sezio # --question-- -Questi campi sono usati per le domande a scelta multipla delle sfide di Python. +These fields are currently used for the multiple-choice Python challenges. ## --text-- -Il testo della domanda va qui. +The question text goes here. ## --answers-- -Risposa 1 +Answer 1 --- -Risposta 2 +Answer 2 --- -Altre risposte +More answers ## --video-solution-- -Il numero della risposta corretta va qui. +The number for the correct answer goes here. ```` > [!NOTE] @@ -186,9 +190,9 @@ $ ObjectId() ObjectId("5a474d78df58bafeb3535d34") ```` -Il risultato è un nuovo id, per esempio sopra `5a474d78df58bafeb3535d34`. +The result is a new id, for example `5a474d78df58bafeb3535d34` above. -Una volta che hai il tuo id, mettilo nel file markdown nel campo `id` in cima, per esempio +Once you have your id, put it into the markdown file as the `id` field at the top, e.g. ```yml --- @@ -198,13 +202,13 @@ title: Challenge Title ## Dare un nome alle sfide -Dare un nome alle cose è difficile. Lo abbiamo reso più semplice dando dei limiti. +Naming things is hard. We've made it easier by imposing some constraints. -Tutti i titoli delle sfide devono essere espliciti e seguire questo schema: +All challenge titles should be explicit and should follow this pattern: -\[verbo\]\[complemento oggetto\] +\[verb\]\[object clause\] -Ecco alcuni esempi di nomi di sfide: +Here are some example challenge names: - Usare la notazione in senso orario per specificare il padding di un elemento - Condensare array usando .reduce @@ -212,19 +216,19 @@ Ecco alcuni esempi di nomi di sfide: ## Istruzioni e descrizione di una sfida -Le frasi dovrebbero essere chiare e concise con minimo utilizzo di linguaggio tecnico. Se il linguaggio tecnico è usato, deve essere subito seguito da una definizione in linguaggio comune. +Sentences should be clear and concise with minimal jargon. If used, jargon should be immediately defined in plain English. -I paragrafi devono essere corti (1-4 frasi circa). È più probabile che vengano lette alcune frasi corte invece di un muro di testo. +Keep paragraphs short (around 1-4 sentences). People are more likely to read several short paragraphs than a wall of text. -Il testo della sfida dovrebbe usare la seconda persona ("tu") per aiutare ad avere un tono colloquiale. In questo modo il testo e le istruzioni sembrano parlare direttamente al camper che lavora sulle sfide. Cerca di evitare la prima persona ("io", "noi", "facciamo"). +Challenge text should use the second person ("you") to help to give it a conversational tone. This way the text and instructions seem to speak directly to the camper working through the challenge. Try to avoid using the first person ("I", "we", "let's", and "us"). -Non usare link a siti esterni. Questi interrompono il flusso. I camper non dovrebbero mai cercare qualcosa su Google durante queste sfide. Se ci sono risorse di cui pensi che il camper possa beneficiare, aggiungile all'articolo della sfida nella guida. +Don't use outbound links. These interrupt the flow. Campers should never have to google anything during these challenges. If there are resources you think campers would benefit from, add them to the challenge's Guide-related article. -Puoi aggiugere diagrammi se necessario. +You can add diagrams if necessary. -Non usare emoji o emoticon nelle sfide. freeCodeCamp ha una comunità globale, e il significato culturare di una emoji o emoticon può essere differente nelle varie parti del mondo. In più, le emoji possono avere un aspetto diverso su diversi sistemi. +Don't use emojis or emoticons in challenges. freeCodeCamp has a global community, and the cultural meaning of an emoji or emoticon may be different around the world. Also, emojis can render differently on different systems. -I nomi propri dovrebbero usare le maiuscole correttamente quando possibile. Qui sotto trovi una lista di parole come dovrebbero apparire nelle sfide. +Proper nouns should use correct capitalization when possible. Below is a list of words as they should appear in the challenges. - JavaScript (lettere maiuscole in "J" e "S" e senza abbreviazioni) - Node.js @@ -232,28 +236,28 @@ I nomi propri dovrebbero usare le maiuscole correttamente quando possibile. Qui ### La regola dei due minuti -Ogni sfida dovrebbe essere risolvibile entro 120 secondi da un nativo inglese che ha completato tutte le sfide precedenti. Questo include l'ammontare di tempo necessario a leggere le istruzioni, comprendere il codice di partenza, scrivere il loro codice e avere tutti i test superati. +Each challenge should be solvable within 120 seconds by a native English speaker who has completed the challenges leading up to it. This includes the amount of time it takes to read the directions/instructions understand the seeded code, write their code and get all the tests to pass. -Se servono più di due minuti a completare la sfida hai due possibilità: +If it takes longer than two minutes to complete the challenge, you have two options: - Semplificare la sfida, o - Dividere la sfida in due sfide. -La regola dei due minuti obbliga te, designer della sfida, a rendere le tue istruzioni concise, il tuo codice seed chiaro, e i tuoi test diretti. +The 2-minute rule forces you, the challenge designer, to make your directions concise, your seed code clear, and your tests straight-forward. -Teniamo traccia di quanto tempo serve ai camper per risolvere le sfide e usiamo questa informazione per identificare sfide che devono essere semplificate o divise. +We track how long it takes for campers to solve changes and use this information to identify challenges that need to be simplified or split. ### Modularità -Ogni sfida dovrebbe insegnare esattamente un concetto, e quel concetto dovrebbe apparire nel titolo della sfida. +Each challenge should teach exactly one concept, and that concept should be apparent from the challenge's name. -Possiamo rinforzare concetti introdotti in precedenza tramite ripetizione e variazioni, per esempio introducendo gli elementi h1 in una sfida e gli elementi h3 alcune sfide più tardi. +We can reinforce previously covered concepts through repetition and variations - for example, introducing h1 elements in one challenge, then h3 elements a few challenges later. -Il nostro obbiettivo è di avere migliaia di sfide da due minuti. Queste possono scorrere insieme e rinforzare concetti già introdotti in precedenza. +Our goal is to have thousands of 2-minute challenges. These can flow together and reiterate previously-covered concepts. ### Formattare il testo delle sfide -Ecco le linee guidee di formattazione specifiche per il testo delle sfide e degli esempi: +Here are specific formatting guidelines for challenge text and examples: - Le parole chiave del linguaggio vanno in `` \` `` backtick. Per esempio i nomi dei tag HTML o i nomi delle proprietà CSS. - Riferimenti a parti di codice (come nomi di funzioni, metodi o variabili) dovrebbero essere in `` \` `` backtick. Vedi gli esempi seguenti: @@ -266,9 +270,9 @@ Usa `parseInt` per convertire la variabile `realNumber` a un numero intero. - I blocchi di codice multi-riga **devono essere preceduti da una riga vuota**. La riga successiva deve iniziare con tre backticks seguiti immediatamente da uno dei [linguaggi supportati](https://prismjs.com/#supported-languages). Per completare il blocco di codice devi iniziare una nuova riga, scrivere tre backtick e poi **un'altra riga vuota**. Vedi l'esempio seguente: - Gli spazi bianchi hanno significato in Markdown, raccomandiamo di renderli visibili nel tuo editor. -**Nota:** Se devi usare un esempio di codice in YAML, usa `yaml` invece di `yml` per il linguaggio a fianco dei tre backtick. +**Note:** If you are going to use an example code in YAML, use `yaml` instead of `yml` for the language to the right of the backticks. -Il seguente è un esempio di codice: +The following is an example of code: ````md ```{language} @@ -312,13 +316,13 @@ Esempio di un commento a linea singola in JavaScript: // Only change code below this line ```` -Esempio di un commento CSS valido: +Example of a valid CSS comment: ```css /* Only change code above this line */ ``` -Se la sfida ha un unico punto dove il codice ha bisogno di cambiamenti, per favore usa i commenti nel seguente esempio per istruire l'utente su dove dovrebbe fare i cambiamenti. +If a challenge only has a single place where code changes are needed, please use the comments in the following example to instruct the user where changes should be made. ```js var a = 3; @@ -331,7 +335,7 @@ b = 9 + b; c = c + 7; ``` -Se la sfida ha diversi punti dove l'utente deve fare cambiamenti al codice (come in una sfida React) +If a challenge has multiple places where the user is expected to change code (i.e. the React challenges) ```jsx class MyComponent extends React.Component { @@ -364,9 +368,9 @@ class MyComponent extends React.Component { ### Traduzione dei commenti nel codice seed -Ci sono directory separate per ogni lingua. La [versione inglese della directory dei commenti](/curriculum/dictionaries/english/comments.js) è la base per le traduzioni trovate nelle corrispondenti versioni non-inglesi del file. La versione non-inglese della directory dei commenti cinese si trova in `/curriculum/dictionaries/chinese/comments.js`. Ogni directory consiste di un array di oggetti con una proprietà `id` unica e una proprietà `text` che contiene il testo del commento. Solo `text` dovrebbe essere modificato per includere la traduzione del corrispondente commento inglese. +There are separate comment dictionaries for each language. The [English version of the comment dictionary](/curriculum/dictionaries/english/comments.js) is the basis for the translations found in the corresponding non-English versions of the files. The non-English version of the Chinese comment dictionary would be located at `/curriculum/dictionaries/chinese/comments.js`. Each dictionary consists of an array of objects with a unique `id` property and a `text` property. Only the `text` should be modified to encompass the translation of the corresponding English comment. -Alcuni commenti potrebbero contenere delle parole o frasi che non devono essere tradotte. Per esempio, nomi di variabili o nomi propri di librerie come "React" non dovrebbero essere tradotti. Vedi il commento seguente come esempio. La parola `myGlobal` non deve essere tradotta. +Some comments may contain a word/phrase that should not be translated. For example, variable names or proper library names like "React" should not be translated. See the comment below as an example. The word `myGlobal` should not be translated. ```text Declare the myGlobal variable below this line @@ -378,13 +382,13 @@ Declare the myGlobal variable below this line ## Suggerimenti e soluzioni -Ogni sfida ha un pulsante `Get a Hint` (Ottieni un suggerimento), cosicché un utente possa avere accesso a suggerimenti e soluzioni che sono stati creati per la sfida. I suggerimenti e le soluzioni del curriculum si trovano nei topic [del nostro forum](https://forum.freecodecamp.org/c/guide) nella categoria `Guide`. +Each challenge has a `Get a Hint` button, so a user can access any hints/solutions which have been created for the challenge. Curriculum hints/solutions topics are located on [our forum](https://forum.freecodecamp.org/c/guide) under the `Guide` category. -Se trovi un problema con i suggerimenti e le soluzioni delle sfide puoi inviare i tuoi suggerimenti aprendo un topic nella [categoria contributors](https://forum.freecodecamp.org/c/contributors) sul forum. Moderatori e utenti con un livello di fiducia 3 rivedranno i tuoi commenti e decideranno se includere o meno i cambiamenti nel topic corrispondente. +If you find a problem with an existing challenge's hints/solutions topic, you can make suggestions in the [contributors category](https://forum.freecodecamp.org/c/contributors) on the forum. Moderators and users with trust level 3 will review the comments and decide whether or not to include the changes in the corresponding hint/solutions topic. ### Aggiungere nuovi topic per i suggerimenti e le soluzioni delle sfide -Segui i seguenti step quando crei un nuovo topic per le soluzioni e i suggerimenti di una sfida. +Take the following steps when adding a new challenge hints/solutions related topic. 1. Inizia seguendo gli stessi passaggi per creare un nuovo argomento, ma rivedi il successivo per creare il titolo. 2. Il titolo dell'argomento dovrebbe iniziare con `freeCodeCamp Challenge Guide:` concatenato con il titolo effettivo della sfida del curriculum. Ad esempio, se la sfida è chiamata "`Chunky Monkey`", il titolo dell'argomento sarebbe "`freeCodeCamp Challenge Guide: Chunky Monkey`". @@ -393,7 +397,7 @@ Segui i seguenti step quando crei un nuovo topic per le soluzioni e i suggerimen ### Linee guida per il contenuto dei topic dei suggerimenti e delle soluzioni -Quando proponi una soluzione da aggiungere al topic relativo a una sfida, devi includere tutto il codice. Questo include sia il codice seed originale sia i cambiamenti necessari per superare i test. Dovresti usare il seguente template per creare nuovi topic per suggerimenti e soluzioni: +When proposing a solution for a curriculum challenge related Guide topic, the full code must be added. This includes all the original seed code plus any changes needed to pass all the challenge tests. The following template should be used when creating new hints/solutions topics: ````md # [Qui il nome della sfida] @@ -474,12 +478,12 @@ Puoi anche testare una sfida singola con i seguenti step: cd curriculum ``` -2. Esegui i seguenti comandi per ogni singolo file in cui hai fatto cambiamenti (rimpiazziando `challenge-title-goes-here` con il titolo intero della sfida): +2. Run the following for each challenge file for which you have changed (replacing `challenge-title-goes-here` with the full title of the challenge): ``` npm run test -- -g challenge-title-goes-here ``` -Una volta che avrai verificato che ogni sfida su cui hai lavorato passi i test, [per favore crea una pull request](how-to-open-a-pull-request.md). +Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md). > [!TIP] Puoi impostare la variabile d'ambiente `LOCALE` nel file `.env` alla lingua usata nelle sfide che devi testare. > @@ -487,7 +491,7 @@ Una volta che avrai verificato che ogni sfida su cui hai lavorato passi i test, ### Link utili -Creare e modificare sfide: +Creating and Editing Challenges: 1. [Tipo della sfida (challenge type)](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/utils/challenge-types.js#L1-L13) - cosa significa il tipo di sfida numerico (enum). diff --git a/docs/i18n/japanese/how-to-work-on-coding-challenges.md b/docs/i18n/japanese/how-to-work-on-coding-challenges.md index af03d7fd4b..36ade2941a 100644 --- a/docs/i18n/japanese/how-to-work-on-coding-challenges.md +++ b/docs/i18n/japanese/how-to-work-on-coding-challenges.md @@ -73,6 +73,10 @@ assert.equal( ); ``` +# --notes-- + +Extra information for a challenge, in markdown + # --seed-- ## --before-user-code-- diff --git a/docs/i18n/portuguese/how-to-work-on-coding-challenges.md b/docs/i18n/portuguese/how-to-work-on-coding-challenges.md index ff764ba282..2fe19fdbbe 100644 --- a/docs/i18n/portuguese/how-to-work-on-coding-challenges.md +++ b/docs/i18n/portuguese/how-to-work-on-coding-challenges.md @@ -73,6 +73,10 @@ assert.equal( ); ``` +# --notes-- + +Extra information for a challenge, in markdown + # --seed-- ## --before-user-code-- @@ -89,7 +93,7 @@ Código avaliado após o código do usuário, e pouco antes dos testes ## --seed-contents-- -Código Boilerplate para renderizar para o editor. Esta seção deve somente conter código dentro de crases, como o seguinte exemplo: +Boilerplate code to render to the editor. This section should only contain code inside backticks, like the following: ```html @@ -114,7 +118,7 @@ console.log('freeCodeCamp is awesome!'); # --solutions-- -Soluções são usadas para os testes CI a fim de garantir que mudanças nas dicas ainda passem conforme o esperado +Solutions are used for the CI tests to ensure that changes to the hints will still pass as intended ```js // primeira solução - a(s) linguagem(ns) deve(m) ser a mesma do código fornecido. @@ -134,27 +138,27 @@ Soluções são usadas para os testes CI a fim de garantir que mudanças nas dic # --question-- -Esses espaços são utilizados geralmente para questões de múltipla escolha dos desafios de Python. +These fields are currently used for the multiple-choice Python challenges. ## --text-- -O texto da pergunta vêm aqui. +The question text goes here. ## --answers-- -Resposta 1 +Answer 1 --- -Resposta 2 +Answer 2 --- -Mais respostas +More answers ## --video-solution-- -O número da resposta correta fica aqui. +The number for the correct answer goes here. ```` > [!NOTE] @@ -186,9 +190,9 @@ $ ObjectId() ObjectId("5a474d78df58bafeb3535d34") ```` -O resultado é um novo id, por exemplo `5a474d78df58bafeb3535d34` acima. +The result is a new id, for example `5a474d78df58bafeb3535d34` above. -Quando tiver seu id, coloque-o no arquivo markdown como campo `id` no topo, ex. +Once you have your id, put it into the markdown file as the `id` field at the top, e.g. ```yml --- @@ -198,13 +202,13 @@ title: Título do desafio ## Nomeando desafios -Nomear coisas é difícil. Nós facilitamos com algumas restrições. +Naming things is hard. We've made it easier by imposing some constraints. -Todos os títulos dos desafios devem estar explícitos e devem seguir este padrão: +All challenge titles should be explicit and should follow this pattern: -\[verb\]\[frase objetiva\] +\[verb\]\[object clause\] -Aqui estão alguns exemplos de nomes para desafios: +Here are some example challenge names: - Usar a notação de sentido horário para especificar o preenchimento (padding) de um elemento - Condensar arrays com .reduce @@ -212,19 +216,19 @@ Aqui estão alguns exemplos de nomes para desafios: ## Descrições/instruções do desafio -As frases devem ser claras e resumidas com o mínimo de termos técnicos. Se usado, o termo técnico deve ser imediatamente definido em inglês simples. +Sentences should be clear and concise with minimal jargon. If used, jargon should be immediately defined in plain English. -Mantenha os parágrafos curtos (em torno de 1-4 frases). É mais provável que as pessoas leiam vários parágrafos curtos do que um parágrafo enorme. +Keep paragraphs short (around 1-4 sentences). People are more likely to read several short paragraphs than a wall of text. -O texto do desafio deve usar a segunda pessoa ("você") para ajudar a dar um tom de conversa. Dessa forma, o texto e as instruções parecem falar diretamente ao usuário freeCodeCamp que está resolvendo o desafio. Tente evitar usar a primeira pessoa ("eu", "nós", "vamos"). +Challenge text should use the second person ("you") to help to give it a conversational tone. This way the text and instructions seem to speak directly to the camper working through the challenge. Try to avoid using the first person ("I", "we", "let's", and "us"). -Não use links externos. Eles interrompem o fluxo. Os usuários freeCodeCamp nunca devem precisar pesquisar nada no Google durante esses desafios. Se há recursos que você acha que os usuários irão se beneficiar, adicione-os no artigo relacionado ao guia do desafio. +Don't use outbound links. These interrupt the flow. Campers should never have to google anything during these challenges. If there are resources you think campers would benefit from, add them to the challenge's Guide-related article. -Você pode adicionar diagramas se necessário. +You can add diagrams if necessary. -Não use emojis ou emoticons em desafios. O freeCodeCamp possui uma comunidade global, e o significado cultural de um emoji ou emoticon pode ser diferente ao redor do mundo. Além disso, emojis podem ser mostrados de maneiras diferentes em diferentes sistemas. +Don't use emojis or emoticons in challenges. freeCodeCamp has a global community, and the cultural meaning of an emoji or emoticon may be different around the world. Also, emojis can render differently on different systems. -Substantivos próprios devem começar com letra maiúscula quando possível. Abaixo está uma lista de palavras e como devem aparecem nos desafios. +Proper nouns should use correct capitalization when possible. Below is a list of words as they should appear in the challenges. - JavaScript (letras maiúsculas em "J" e "S" e sem abreviações) - Node.js @@ -232,28 +236,28 @@ Substantivos próprios devem começar com letra maiúscula quando possível. Aba ### A regra dos 2 minutos -Cada desafio deve ser resolvido em 120 segundos por um nativo da língua inglesa que tenha concluído os desafios anteriores. Isso inclui a quantidade de tempo que leva para ler as instruções, entender o código fornecido, escrever o código e passar nos testes. +Each challenge should be solvable within 120 seconds by a native English speaker who has completed the challenges leading up to it. This includes the amount of time it takes to read the directions/instructions understand the seeded code, write their code and get all the tests to pass. -Se levar mais do que dois minutos para completar um desafio, você tem duas opções: +If it takes longer than two minutes to complete the challenge, you have two options: - Simplifique o desafio, ou - Divida o desafio em dois desafios. -A regra dos 2 minutos força quem criou o desafio a deixar as instruções resumidas, o código fornecido limpo e seus testes diretos. +The 2-minute rule forces you, the challenge designer, to make your directions concise, your seed code clear, and your tests straight-forward. -Acompanhamos quanto dura para os usuários resolverem mudanças e usamos essa informação para identificar desafios que precisam ser simplificados ou divididos. +We track how long it takes for campers to solve changes and use this information to identify challenges that need to be simplified or split. ### Modularidade -Cada desafio deve ensinar exatamente um conceito, e esse conceito deve estar aparente a partir do nome do desafio. +Each challenge should teach exactly one concept, and that concept should be apparent from the challenge's name. -Podemos reforçar conceitos citados anteriormente através de repetição e variações - por exemplo, introduzir elementos h1 em um desafio, então elementos h3 depois. +We can reinforce previously covered concepts through repetition and variations - for example, introducing h1 elements in one challenge, then h3 elements a few challenges later. -Nossa meta é ter vários desafios de 2 minutos. Eles podem se completar e relembrar conceitos anteriormente citados. +Our goal is to have thousands of 2-minute challenges. These can flow together and reiterate previously-covered concepts. ### Formatando o texto do desafio -Aqui estão diretrizes de formatação específicas para o texto do desafio e exemplos: +Here are specific formatting guidelines for challenge text and examples: - Palavras chaves da linguagem ficam entre `` \` `` crases. Por exemplo, nomes de tags HTML ou nomes de propriedade CSS. - Referências a códigos (ex. função, método ou nomes de variáveis) devem estar entre `` \` ``. Veja o exemplo abaixo: @@ -266,9 +270,9 @@ Use `parseInt` para converter a variável `realNumber` em um número inteiro. - Blocos de código com várias linhas **devem ser precedidos por uma linha vazia**. A próxima linha deve começar com três crases seguidas imediatamente por uma das [linguagens suportadas](https://prismjs.com/#supported-languages). Para completar o bloco de código, você deve começar uma nova linha que apenas possui três crases e **outra linha vazia**. Veja o exemplo abaixo: - Os espaços importam no Markdown. Então, recomendamos que os mantenham visíveis no seu editor. -**Observação:** se você for usar um exemplo de códigoem YAML, use `yaml` ao invés de `yml` para a linguagem na direita das crases. +**Note:** If you are going to use an example code in YAML, use `yaml` instead of `yml` for the language to the right of the backticks. -A seguir um exemplo do código: +The following is an example of code: ````md ```{language} @@ -315,13 +319,13 @@ Exemplo de um comentário de uma linha em JavaScript: // Mude somente abaixo dessa linha ```` -Exemplo de um comentário válido em CSS: +Example of a valid CSS comment: ```css /* Only change code above this line */ ``` -Se um desafio tem apenas um lugar onde as mudanças de código são necessárias, use os comentários seguindo o exemplo a seguir para instruir o usuário sobre o local onde as mudanças devem ser feitas. +If a challenge only has a single place where code changes are needed, please use the comments in the following example to instruct the user where changes should be made. ```js var a = 3; @@ -334,7 +338,7 @@ b = 9 + b; c = c + 7; ``` -Se um desafio tem múltiplos lugares onde se espera que o usuário faça mudanças no código (ex. os desafios de React) +If a challenge has multiple places where the user is expected to change code (i.e. the React challenges) ```jsx class MyComponent extends React.Component { @@ -367,9 +371,9 @@ class MyComponent extends React.Component { ### Tradução de comentários de código seed -Existem dicionários de comentários separados para cada linguagem. A [versão em inglês do dicionário de comentários](/curriculum/dictionaries/english/comments.js) é a base para as traduções encontradas nas versões correspondentes dos arquivos em outros idiomas. A versão não inglesa do dicionário de comentário chinesa pode ser encontrada em `/curriculum/dictionaries/chinese/comments.js`. Cada dicionário consiste em um array de objetos com uma propriedade de `id` única e uma propriedade de `text`. Somente a propriedade `text` deve ser modificada para englobar a tradução do comentário correspondente em inglês. +There are separate comment dictionaries for each language. The [English version of the comment dictionary](/curriculum/dictionaries/english/comments.js) is the basis for the translations found in the corresponding non-English versions of the files. The non-English version of the Chinese comment dictionary would be located at `/curriculum/dictionaries/chinese/comments.js`. Each dictionary consists of an array of objects with a unique `id` property and a `text` property. Only the `text` should be modified to encompass the translation of the corresponding English comment. -Alguns comentários podem conter uma palavra/frase que não deve ser traduzida. Por exemplo, nomes de variáveis, ou nomes próprios de bibliotecas como "React" não devem ser traduzidas. Veja o comentário abaixo como um exemplo. a palavra `myGlobal` não deve ser traduzida. +Some comments may contain a word/phrase that should not be translated. For example, variable names or proper library names like "React" should not be translated. See the comment below as an example. The word `myGlobal` should not be translated. ```text Declare a variável myGlobal abaixo desta linha @@ -381,13 +385,13 @@ Declare a variável myGlobal abaixo desta linha ## Dicas e soluções -Cada desafio tem um botão `Get a Hint`, assim, o usuário pode acessar qualquer dica/solução que foi criada para aquele desafio. Os tópicos de dicas/soluções são encontrados no [nosso fórum](https://forum.freecodecamp.org/c/guide), abaixo da categoria `Guide`. +Each challenge has a `Get a Hint` button, so a user can access any hints/solutions which have been created for the challenge. Curriculum hints/solutions topics are located on [our forum](https://forum.freecodecamp.org/c/guide) under the `Guide` category. -Se você encontrar um problema nas dicas/tópicos de solução de um desafio existente, você pode fazer sugestões na [categoria de contribuidores](https://forum.freecodecamp.org/c/contributors) no fórum. Os moderadores e usuários com o nível de confiança 3 vão revisar os comentários e decidir quais incluir as mudanças nos tópicos correspondentes de dicas/soluções. +If you find a problem with an existing challenge's hints/solutions topic, you can make suggestions in the [contributors category](https://forum.freecodecamp.org/c/contributors) on the forum. Moderators and users with trust level 3 will review the comments and decide whether or not to include the changes in the corresponding hint/solutions topic. ### Adicionando um novo tópico de dicas/soluções em um desafio -Faça o passo-a-passo a seguir quando for adicionar novos tópicos de dicas/soluções relacionadas a um desafio. +Take the following steps when adding a new challenge hints/solutions related topic. 1. Comece seguindo os mesmos passos para criar um novo tópico, mas revise o seguinte para criar o título. 2. O título do tópico deve começar com `freeCodeCamp Challenge Guide:` concatenado com o título atual do desafio de currículo. Por exemplo, se o desafio é chamado "`Chunky Monkey`", o título do tópico seria "`freeCodeCamp Challenge Guide: Chunky Monkey`". @@ -396,7 +400,7 @@ Faça o passo-a-passo a seguir quando for adicionar novos tópicos de dicas/solu ### Diretrizes para o conteúdo dos tópicos de dicas e soluções -Ao propor uma solução para um tópico do guia relacionado a um desafio de currículo, o código completo deve ser adicionado. Isso inclui todo o código seed original, assim como as alterações necessárias para passar em todos os testes do desafio. O modelo a seguir deve ser usado ao criar um novo tópico de dicas/soluções: +When proposing a solution for a curriculum challenge related Guide topic, the full code must be added. This includes all the original seed code plus any changes needed to pass all the challenge tests. The following template should be used when creating new hints/solutions topics: ````md # O nome do desafio fica aqui @@ -477,12 +481,12 @@ Você também é capaz de testar um desafio individualmente seguindo as seguinte cd curriculum ``` -2. Execute o comando a seguir para cada arquivo de desafio que você fez mudanças (substituindo `challenge-title-goes-here` com o título completo do desafio): +2. Run the following for each challenge file for which you have changed (replacing `challenge-title-goes-here` with the full title of the challenge): ``` npm run test -- -g challenge-title-goes-here ``` -Quando você verificou que cada desafio modificado passou nos testes, [crie um pull request](how-to-open-a-pull-request.md). +Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md). > [!TIP] Você pode definir a variável de ambiente `LOCALE` no `.env` no idioma do(s) desafio(s) que precisa testar. > @@ -490,7 +494,7 @@ Quando você verificou que cada desafio modificado passou nos testes, [crie um p ### Links úteis -Criando e editando desafios: +Creating and Editing Challenges: 1. [Tipos de desafio](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/utils/challenge-types.js#L1-L13) - o que significam os valores do tipo de desafio numérico (enum). diff --git a/docs/i18n/ukrainian/how-to-work-on-coding-challenges.md b/docs/i18n/ukrainian/how-to-work-on-coding-challenges.md index af03d7fd4b..36ade2941a 100644 --- a/docs/i18n/ukrainian/how-to-work-on-coding-challenges.md +++ b/docs/i18n/ukrainian/how-to-work-on-coding-challenges.md @@ -73,6 +73,10 @@ assert.equal( ); ``` +# --notes-- + +Extra information for a challenge, in markdown + # --seed-- ## --before-user-code--