Skip to content
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

Adição de termos técnicos #156

Open
wants to merge 1 commit into
base: main
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
66 changes: 66 additions & 0 deletions assets/data/cards_pt-br.json
Original file line number Diff line number Diff line change
Expand Up @@ -482,6 +482,72 @@
"Conceito",
"Back-end"
]
},
{
"title": "NaN",
"description": "A propriedade global NaN é um valor especial que significa Not-A-Number(Não é um número).",
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acho que nessa podemos adicionar um pouco mais de contexto, o que acha?

Suggested change
"description": "A propriedade global NaN é um valor especial que significa Not-A-Number(Não é um número).",
"description": "A propriedade global NaN é um valor especial em programação que significa **Não é um Número**. Ela aparece quando uma operação que deveria resultar em um número acaba não funcionando corretamente. Por exemplo, se você tentar fazer uma conta matemática com algo que não é um número, o resultado pode ser **NaN**.",

"tags": [
"Conceito",
"Back-end",
"Front-end"
Comment on lines +490 to +492
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que aqui podemos deixar apenas a tag de conceito 🤔

]
},
{
"title": "Null",
"description": "Null é um literal que representa um valor nulo ou vazio.",
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que podemos detalhar melhor aqui também. O que acha?

Suggested change
"description": "Null é um literal que representa um valor nulo ou vazio.",
"description": "Null é uma palavra usada na programação para indicar que algo está vazio ou que não tem nenhum valor. É como se fosse uma caixa vazia que ainda não recebeu nada.",

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acho que pode inclusive fazer um referência cruzada entre Null e undefined, citando que podem ser usadas com o mesmo sentido ou não.

"tags": [
"Conceito",
"Back-end",
"Front-end"
Comment on lines +499 to +501
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que aqui podemos deixar apenas a tag de conceito 🤔

]
},
{
"title": "Undefined",
"description": "O valor global undefined representa um valor indefinido, ou seja, um valor que não foi definido ou atribuído em uma variável.",
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Essa explicação utiliza uma analogia simples para tornar o conceito mais acessível, veja se faz sentido:

Suggested change
"description": "O valor global undefined representa um valor indefinido, ou seja, um valor que não foi definido ou atribuído em uma variável.",
"description": "O valor global undefined é usado na programação para mostrar que uma variável ainda não recebeu um valor. É como se você tivesse uma caixa, mas ainda não colocou nada dentro dela.",

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acham que vale adicionar que nem todas as linguagens usam undefined? Algo como:

Enquanto algumas situações em linguagens de programação podem definir um valor padrão para variáveis criadas porém que não receberam algum valor, outras simplesmente usam o conceito de undefined ou NULL.

Eu escrevi algumas situações porque, por exemplo, se criarmos em c

int x;

ele poderia setar x = 0 internamente, o que seria diferente de

int *x;

"tags": [
"Conceito",
"Back-end",
"Front-end"
Comment on lines +508 to +510
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que aqui podemos deixar apenas a tag de conceito 🤔

]
},
{
"title": "Falsy",
"description": "Falsy é um valor que se traduz por falso quando avaliado em um contexto Booleano.",
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trouxe uma sugestão pensando que essapode ser um pouco técnica para quem não está familiarizado com o termo "contexto Booleano", veja o que acha:

Suggested change
"description": "Falsy é um valor que se traduz por falso quando avaliado em um contexto Booleano.",
"description": "Falsy é um valor que, na programação, é considerado como falso quando usado em situações que precisam de uma resposta verdadeira ou falsa. Alguns exemplos de valores falsy são o número 0, uma string vazia ou o próprio null.",

"content": {

"code": "São considerados valores Falsy(false, null, undefined, 0, [], '')"
},
"tags": [
"Conceito",
"Back-end",
"Front-end"
Comment on lines +521 to +523
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que aqui podemos deixar apenas a tag de conceito 🤔

]
},
{
"title": "Truthy",
"description": "Truthy é um valor que se traduz por falso quando avaliado em um contexto Booleano.",
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"truthy" é o oposto de "falsy", veja se essa explicação faz sentido pra você:

Suggested change
"description": "Truthy é um valor que se traduz por falso quando avaliado em um contexto Booleano.",
"description": "Truthy é um valor que é considerado como verdadeiro quando avaliado em uma situação que espera um valor verdadeiro ou falso.",

"content": {

"code": "São considerados valores Truthy(true, Number(42, -42, 3.14, -3.14), Infinity, Strings('foo'))"
},
"tags": [
"Conceito",
"Back-end",
"Front-end"
Comment on lines +534 to +536
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que aqui podemos deixar apenas a tag de conceito 🤔

]
},
{
"title": "Concatenação",
"description": "É o termo que se da quando juntamos um texto a outro por meio do operador (+)",
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Veja o que acha dessa explicação, trazendo um pouco mais de contexto:

Suggested change
"description": "É o termo que se da quando juntamos um texto a outro por meio do operador (+)",
"description": "Concatenação é o termo usado para descrever o processo de unir dois ou mais textos em um único texto. Em muitas linguagens de programação, você usa o operador + para fazer isso. Por exemplo, se você tem a palavra _Olá_ e a palavra _Mundo_, você pode usar + para juntar essas palavras e formar _Olá Mundo_",

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Vale falar que concatenação não é só pra strings, pode ser pra listas ou outros objetos também. Em python, por exemplo, dá pra concatenar dataframes em pandas. Acho que mais importante é dizer que concatenação é um append né, no caso ele adiciona sempre no final do outro objeto.

"content": {

"code": "var one = 'dicio'; var two = 'tech'; var joined = one + two"
},
"tags": [
"Conceito",
"Back-end",
"Front-end"
Comment on lines +547 to +549
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acredito que aqui podemos deixar apenas a tag de conceito 🤔

]
}
]
}