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

Sugestão de reescrita do exercício sobre herança #10

Open
camilaccb opened this issue Oct 12, 2024 · 3 comments
Open

Sugestão de reescrita do exercício sobre herança #10

camilaccb opened this issue Oct 12, 2024 · 3 comments
Assignees
Labels
sugestão-melhoria Para propostas de melhorias no conteúdo do livro, como reformulação de exemplos

Comments

@camilaccb
Copy link
Contributor

camilaccb commented Oct 12, 2024

@HenriqueAJNB fiquei interessada em te mostrar como poderia ficar a sugestão de reescrita desse exercicio que comentei no discord. Acha que faz sentido? Acabei não encontrando uma categoria de issue que se encaixasse.

Segue a minha sugestão:

Nas partes que você coloca o exercicio e numera as etapas para explicar posteriormente pensei que poderia ir montando a solução com as explicações em vez de apresentar o codigo primeiro e depois explicar. Acredito que isso facilitaria um pouco a leitura e a necessidade de ficar descendo e subindo no texto.

image

@HenriqueAJNB
Copy link
Owner

HenriqueAJNB commented Oct 12, 2024

Oi @camilaccb, só pra ver se eu entendi, seria construir o código passo a passo e explicar cada etapa? Meio que construir o código junto com o leitor, seria essa a ideia?

Acho que faz super sentido. Eu, a princípio, tive essa ideia (colocar o código completo e numerar) a partir de livros físicos. Algumas editoras famosas como a O'Reilly e Novatec fazem desta forma.

Mas talvez essa forma seja boa pra livro físico e não pra livro online, pois ir e voltar em páginas físicas não é tão desconfortável quanto subir e descer a barra de rolagem.

Vou aderir à sua sugestão. Acho que dá pra encaixar essa issue como sugestão de melhoria

@camilaccb
Copy link
Contributor Author

Seria justamente essa a ideia, de construir junto com o leitor! Posso fazer um PR para esse exercício em específico?

@HenriqueAJNB
Copy link
Owner

Seria justamente essa a ideia, de construir junto com o leitor! Posso fazer um PR para esse exercício em específico?

Pode sim, vou te colocar como responsável por essa issue então, se precisar de ajuda me avise

@HenriqueAJNB HenriqueAJNB added the sugestão-melhoria Para propostas de melhorias no conteúdo do livro, como reformulação de exemplos label Oct 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
sugestão-melhoria Para propostas de melhorias no conteúdo do livro, como reformulação de exemplos
Projects
None yet
Development

No branches or pull requests

2 participants