javascript-tutorial / javascript-tutorial/en.javascript.info

Page: Decorators and forwarding, call/apply

Aberta
#2,983 7 comentários 1 reação 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
HTML
Estrelas
25.5k
Forks
4k
Métricas de merge de PRs
Nenhum PR com merge em 30d

Descrição

Decorators and forwarding, call/apply
https://javascript.info/call-apply-decorators

Problem
I've discussed the confusion involving this page of the tutorial with Joseph on the discord server. The call and apply function prototype methods should be introduced on their own before touching on the topic of decorators or caches. The comments on this page are also unanimous in describing the content as confusing.

Possible Solutions

Page Title
Joseph proposed a title change to something like "Wrapper functions and call, apply methods". I agree that the title is misleading or poorly worded. Perhaps it should follow the pattern of the other pages' titles in the Advanced working with functions section:

The apply and call methods

Page Content
I believe the content should be rearranged so that discussion of how the apply and call methods work comes first. The topics of decorators and transparent caching can follow afterwards. There are many uses for these methods, so it's a bit confusing to introduce them as a means to write decorators.

Links
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/apply
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/call

I'll try to get Joseph to chime in if possible.

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece pela página do tutorial vinculada e compare a explicação de call/apply, decorators e caching transparente com as referências vinculadas do MDN. Está concluído quando o título estiver mais claro e a página introduzir call/apply antes de decorators e caching, com a ordem revisada refletida no tutorial.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
javascript
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
3/5
Tempo estimado
1-2 dias
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
35/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.