programminghistorian
Proposta de Lição: Investigar a literatura lusófona através dos tempos usando a Literateca
O Programming Historian em Português recebeu uma proposta de lição original com o título provisório "Investigar a literatura lusófona através dos tempos usando a Literateca".
Para promover uma publicação oportuna, propomos que a lição seja entregue em meados de março de 2024. A autora entrará em contato com o editor com antecedência caso não consiga cumprir a data de entrega e precise de uma prorrogação.
Se a lição não for entregue, o editor tentará entrar em contato com a autora da lição. Se nenhuma notícia for recebida, a issue será fechada. Ela poderá ser reaberta no futuro, a pedido da autora.
O contato principal para esta lição é, por enquanto, @ericbrasiln. Se ocorrer algum problema, a autora pode entrar em contato com o mediador do PH em português (Luis Ferla - http://programminghistorian.org/pt/equipe).
@dianamsmpsantos já compartilhou o pacote de submissão comigo, contendo texto markdown, figuras e recursos de dados. Nossa equipe de Publicação (@anisa-hawes e @charlottejmc) processará os novos materiais da lição em setembro e preparará uma prévia do rascunho inicial. Eles discutirão qualquer dúvida com o colaborador e postarão um comentário nesta questão para fornecer a localização de todos os arquivos-chave, bem como um link para a prévia, onde os colaboradores poderão ler a lição conforme o rascunho avança.
Em breve teremos a indicação do/a editor/a responsável pela lição.
Thank you, @ericbrasiln!
@charlottejmc and I will process these submission materials and set up the lesson preview for you this week ✨
Olá @ericbrasiln e @dianamsmpsantos,
Pode encontrar os ficheiros principais aqui:
- .md: /pt/esbocos/originais/investigar-literatura-lusofona-literateca.md
- images: /images/investigar-literatura-lusofona-literateca
- assets: /assets/investigar-literatura-lusofona-literateca
Pode consultar a pré-visualização da lição aqui:
Dear @dianamsmpsantos,
There are a few small things I noticed while setting up your submission, which I have outlined below:
- [x] The code is looking a little strange at lines 162-174; 180-190; 234-246; and 272-286 (in the preview, paragraphs 41-47; 50-55; 71-78; and 88-96). Did you mean to separate the code individually line by line, or were you hoping for them to appear as code blocks instead? If you'd like them to appear as code blocks, I can make that change for you. In general, you might find it easier to read and write your code by simply using single backticks around short bits of code (in-line, or single lines of code).
- [x] I notice you have a list of assets, but none of these files are linked to directly from within the lesson (so that readers can access them). Would you be able to add the links in where relevant? You can point directly to the files on Github, for example like this:
[distribuicaoObra.tsv](https://github.com/programminghistorian/ph-submissions/blob/gh-pages/assets/investigar-literatura-lusofona-literateca/distribuicaoObra.tsv). - [x] Finally, I saw that you provided 'alt-text' for all images, thank you! Unfortunately, it is currently a little under-descriptive, so I'd like to ask whether you might be able to try adding some more information to them.
Alt-text enables screen readers to read the information conveyed in the images for people with visual impairments, different learning abilities, or who cannot otherwise view them, for example due to a slow internet connection. It's important to say that alt-text should go further than repeating the figure captions.
We have found Amy Cesal's guide to Writing Alt Text for Data Visualization useful. This guide advises that alt-text for graphs and data visualisations should consist of the following:
alt="[Chart type] of [data type] where [reason for including chart]"
What Amy Cesal's guide achieves is prompting an author to reflect on their reasons for including the graph or visualisation. What idea does this support? What can a reader learn or understand from this visual?
The Graphs section of Diagram Center's guidance is also useful. Some key points (relevant to all graph types) we can take away from it are:
- Briefly describe the graph and give a summary if one is immediately apparent
- Provide any titles and axis labels
- It is not necessary to describe the visual attributes of the graph (colour, shading, line-style etc.) unless there is an explicit need
- Often, data shown in a graph can be converted into accessible tables
For general images, Harvard's guidance notes some useful ideas. A key point is to keep descriptions simple, and adapt them to the context and purpose for which the image is being included.
Would you feel comfortable redrafting the alt-text for each of the figures? This is certainly a bit time-consuming, but we believe it is very worthwhile in terms of making your lesson accessible to the broadest possible audience. We would be very grateful for your support with this.
Thank you!!
Dear Charlotte, Thanks a lot! Yes, I wanted to create code blocks, but was not able to do it. If you tell me how yo do it, I will gladly do it. I will link to the assets, and try to improve the alt-text descriptions, in both my lessons. I will notify you when this is ready. Thank you for the links. Diana
Thank you, Diana @dianamsmpsantos.
To create inline code, we use single backticks ` before and after the individual words/snippets we want to display as code.
To create code blocks, we use three backticks ``` above and three backticks below the block we want to display as code.
I've done the first one for you so that you can follow this way of working: https://github.com/programminghistorian/ph-submissions/commit/4c0fade852bab155d1b61269a61b06b1b56e6b4c
You can edit your file directly here: /pt/esbocos/originais/investigar-literatura-lusofona-literateca.md.
Just let Charlotte and I know if you have any difficulties, or need advice. We are very happy to help. 🙂
Best, Anisa
Dear @anisa-hawes @charlottejmc and @dianamsmpsantos Thank you very much for the collaboration and work on the process of publishing these original lessons in Portuguese! I'm sure we will have a great result in the end. best
Dear Anisa, I am having the following error: "There was an error committing your changes: File could not be edited" What can I do to solve it? Thanks a lot in advance Diana
Anisa Hawes @.***> escreveu (quinta, 5/09/2024 à(s) 12:53):
Thank you, Diana @dianamsmpsantos https://github.com/dianamsmpsantos.
To create inline code, we use single backticks ` before and after the individual words/snippets we want to display as code. To create code blocks, we use three backticks ``` above and three backticks below the block we want to display as code.
I've done the first one for you so that you can follow this way of working: 4c0fade https://github.com/programminghistorian/ph-submissions/commit/4c0fade852bab155d1b61269a61b06b1b56e6b4c
You can edit your file directly here: /pt/esbocos/originais/investigar-literatura-lusofona-literateca.md https://github.com/programminghistorian/ph-submissions/blob/gh-pages/pt/esbocos/originais/investigar-literatura-lusofona-literateca.md .
Just let Charlotte and I know if you have any difficulties, or need advice. We are very happy to help. 🙂
Best, Anisa
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2331216937, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44U66GLI2TDJF5A35KTZVAZ4JAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZRGIYTMOJTG4 . You are receiving this because you were mentioned.Message ID: @.***>
Hello Diana @dianamsmpsantos,
I have double checked that you have the Write access you need to contribute to our repository. I note that you have successfully made several edits to the Markdown file. Does this mean the problem is now solved?
Or are you trying to edit some other kinds of files? (for example data assets or figure images) In this case, it is usually necessary to delete and then replace the file. Please let @charlottejmc or I know what you would like to edit, and we can help you directly / or make the changes on your behalf.
Thank you for your patience. Anisa
Dear Anisa, I am sorry, I had been thrown away from github, and this is why I was not able to edit or make changes. Now I logged in again, and made all subsequent changes. I want only to change one figure, figure 8, because I found an error in it. Should I try to remove and upload the new one, or send it directly to you? Best Diana
Anisa Hawes @.***> escreveu (sexta, 6/09/2024 à(s) 10:14):
Hello Diana @dianamsmpsantos https://github.com/dianamsmpsantos,
I have double checked that you have Write access you need to contribute to this repository. I note that you have successfully made several edits to the Markdown file https://github.com/programminghistorian/ph-submissions/commits/gh-pages/pt/esbocos. Does this mean the problem is now solved?
Or are you trying to edit some other kinds of files? (for example data assets or figure images) In this case, it is usually necessary to delete and then replace the file. Please let @charlottejmc https://github.com/charlottejmc or I know what you would like to edit, and we can help you directly / or make the changes on your behalf.
Thank you for your patience. Anisa
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2333499458, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44T5Z7JAJFLLU3JK25DZVFP5PAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZTGQ4TSNBVHA . You are receiving this because you were mentioned.Message ID: @.***>
Ah! That explains it!
Thank you, @dianamsmpsantos. Could you email it to Charlotte please? (publishing.assistant[@]programminghistorian.org).
Thank you, A.
Sorry again, I need to change a lot of data files and at least two figures. (I found out that there was a typo in a date, and therefore one text was in the 12th century instead of the 20th... And this shows clearly in the distributions by decade.) So, please tell me how to proceed. Diana
Diana Santos @.***> escreveu (sexta, 6/09/2024 à(s) 10:47):
Dear Anisa, I am sorry, I had been thrown away from github, and this is why I was not able to edit or make changes. Now I logged in again, and made all subsequent changes. I want only to change one figure, figure 8, because I found an error in it. Should I try to remove and upload the new one, or send it directly to you? Best Diana
Anisa Hawes @.***> escreveu (sexta, 6/09/2024 à(s) 10:14):
Hello Diana @dianamsmpsantos https://github.com/dianamsmpsantos,
I have double checked that you have Write access you need to contribute to this repository. I note that you have successfully made several edits to the Markdown file https://github.com/programminghistorian/ph-submissions/commits/gh-pages/pt/esbocos. Does this mean the problem is now solved?
Or are you trying to edit some other kinds of files? (for example data assets or figure images) In this case, it is usually necessary to delete and then replace the file. Please let @charlottejmc https://github.com/charlottejmc or I know what you would like to edit, and we can help you directly / or make the changes on your behalf.
Thank you for your patience. Anisa
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2333499458, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44T5Z7JAJFLLU3JK25DZVFP5PAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZTGQ4TSNBVHA . You are receiving this because you were mentioned.Message ID: @.***>
Ok, I'll do it! Thank you Diana
Anisa Hawes @.***> escreveu (sexta, 6/09/2024 à(s) 10:51):
Ah! That explains it!
Thank you, @dianamsmpsantos https://github.com/dianamsmpsantos. Could you email it to Charlotte please? (publishing.assistant[@] programminghistorian.org).
Thank you, A.
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2333565276, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44RSDTYC5NHZWVXD3K3ZVFUJJAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZTGU3DKMRXGY . You are receiving this because you were mentioned.Message ID: @.***>
Thank you, @dianamsmpsantos.
Sem problema! Please email @charlottejmc a list of these edits, and share the new files with her. Charlotte can re-process the files and make the adjustments needed ☺️
Thank you @dianamsmpsantos, I've now replaced those files with the new versions you've sent by email ✨
Thank you, @charlottejmc https://github.com/charlottejmc! There are still two problems, though: Figure 9 disappeared. Should I send it to you again? And paragraph 36 should be inside note 7, not in the main text. Can you help me with this? Otherwise I think the lesson is ready. Best Diana
charlottejmc @.***> escreveu (quarta, 11/09/2024 à(s) 10:00):
Thank you @dianamsmpsantos https://github.com/dianamsmpsantos, I've now replaced those files with the new versions you've sent by email ✨
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2342929878, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44T2XYRJVA4IBQ6AT63ZV72AJAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGNBSHEZDSOBXHA . You are receiving this because you were mentioned.Message ID: @.***>
Thanks for flagging this @dianamsmpsantos! It should all be working as expected now.
Thank you, everything is fixed. Is there anything else I need to do? Best, Diana
charlottejmc @.***> escreveu (quarta, 11/09/2024 à(s) 11:11):
Thanks for flagging this @dianamsmpsantos https://github.com/dianamsmpsantos! It should all be working as expected now.
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2343084380, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44R5B3QJLXRPZ3LO3XDZWACMLAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGNBTGA4DIMZYGA . You are receiving this because you were mentioned.Message ID: @.***>
Hi @dianamsmpsantos, I've checked off my three tick-boxes from my initial comment as I can see you've worked on those. Your lesson is ready to move on to Phase 2: Initial Edit!
But since this is my first time, what does this mean? What do I need to do now? Thanks in advance
charlottejmc @.***> escreveu (quarta, 11/09/2024 à(s) 13:39):
Hi @dianamsmpsantos https://github.com/dianamsmpsantos, I've checked off my three tick-boxes from my initial comment https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2330726031 as I can see you've worked on those. Your lesson is ready to move on to Phase 2: Initial Edit!
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2343430566, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44VSJ3F2QADJWQSPHWDZWATWBAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGNBTGQZTANJWGY . You are receiving this because you were mentioned.Message ID: @.***>
Olá Diana @dianamsmpsantos,
What's happening now?
Your lesson has been moved to the next phase of our workflow which is Phase 2: Initial Edit.
In this phase, your editor Eric @ericbrasiln will read your lesson, and provide some initial feedback. Eric will post feedback and suggestions as a comment in this issue, so that you can revise your draft in the following phase (Phase 3: Revision 1).
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
'cScale1': '#886814', 'cScaleLabel1': '#ffffff',
'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
} } }%%
timeline
Section Phase 1 <br> Submission
Who worked on this? : Publishing Assistant (@charlottejmc)
All Phase 1 tasks completed? : Yes
Section Phase 2 <br> Initial Edit
Who's working on this? : Editor (@ericbrasiln)
Expected completion date? : October 11
Section Phase 3 <br> Revision 1
Who's responsible? : Author (@dianamsmpsantos)
Expected timeframe? : ~30 days after feedback is received
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
Hi @anisa-hawes,
Just like with the other lesson from Diana, I’ve already reviewed this one, and the initial feedback and comments were addressed during our previous discussions. We’re ready to move forward to the next phase. I’m also in the process of finding editors for this lesson.
Best regards
Olá Diana @dianamsmpsantos,
What's happening now?
Your lesson has been moved to the next phase of our workflow which is Phase 3: Revision 1.
I understand that you have already revised your draft in response to @ericbrasiln's initial feedback. As you and Eric are both happy with this revised draft, we will now move forward to Phase 4: Open Peer Review.
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
'cScale1': '#886814', 'cScaleLabel1': '#ffffff',
'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
} } }%%
timeline
Section Phase 2 <br> Initial Edit
Who worked on this? : Editor (@ericbrasiln)
All Phase 2 tasks completed? : Yes
Section Phase 3 <br> Revision 1
Who's working on this? : Author (@dianamsmpsantos)
Expected completion date? : DONE
Section Phase 4 <br> Open Peer Review
Who's responsible? : Reviewers (TBC)
Expected timeframe? : ~60 days after request is accepted
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
Olá Diana @dianamsmpsantos,
What's happening now?
Your lesson has been moved to the next phase of our workflow which is Phase 4: Open Peer Review.
This phase is an opportunity for you to hear feedback from peers in the community.
Eric @ericbrasiln will invite two reviewers to read your lesson, test your code, and provide constructive feedback. In the spirit of openness, reviews will be posted as comments in this issue (unless you specifically request a closed review).
After both reviews, Eric will summarise the suggestions to clarify your priorities in Phase 5: Revision 2.
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
'cScale1': '#886814', 'cScaleLabel1': '#ffffff',
'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
} } }%%
timeline
Section Phase 3 <br> Revision 1
Who worked on this? : Author (@dianamsmpsantos)
All Phase 3 tasks completed? : Yes
Section Phase 4 <br> Open Peer Review
Who's working on this? : Reviewers (TBC)
Expected completion date? : ~60 days after request is accepted
Section Phase 5 <br> Revision 2
Who's responsible? : Author (@dianamsmpsantos)
Expected timeframe? : ~30 days after editor's summary
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
Thank you all. Can I also invite reviews from colleagues? In that case, how can they see the lesson(s)? Thanks a lot in advance Diana
Anisa Hawes @.***> escreveu (quarta, 2/10/2024 à(s) 16:14):
Olá Diana @dianamsmpsantos https://github.com/dianamsmpsantos, What's happening now?
Your lesson has been moved to the next phase of our workflow which is Phase 4: Open Peer Review.
This phase is an opportunity for you to hear feedback from peers in the community.
Eric @ericbrasiln https://github.com/ericbrasiln will invite two reviewers to read your lesson, test your code, and provide constructive feedback. In the spirit of openness, reviews will be posted as comments in this issue (unless you specifically request a closed review).
After both reviews, Eric will summarise the suggestions to clarify your priorities in Phase 5: Revision 2.
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': { 'cScale0': '#444444', 'cScaleLabel0': '#ffffff', 'cScale1': '#886814', 'cScaleLabel1': '#ffffff', 'cScale2': '#444444', 'cScaleLabel2': '#ffffff' } } }%% timeline Section Phase 3
Revision 1 Who worked on this? : Author @.) All Phase 3 tasks completed? : Yes Section Phase 4
Open Peer Review Who's working on this? : Reviewers (TBC) Expected completion date? : ~60 days after request is accepted Section Phase 5
Revision 2 Who's responsible? : Author @.) Expected timeframe? : ~30 days after editor's summaryLoading
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
— Reply to this email directly, view it on GitHub https://github.com/programminghistorian/ph-submissions/issues/599#issuecomment-2388758509, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB6H44U3N5PZ6L537OBULALZZP5TZAVCNFSM6AAAAABCHNDWUCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGOBYG42TQNJQHE . You are receiving this because you were mentioned.Message ID: @.***>
Hello Diana @dianamsmpsantos,
Yes! Of course. We welcome additional reviews from your colleagues ! Members of the wider community may also choose to contribute reviews.
The lesson is available to read as a preview here: http://programminghistorian.github.io/ph-submissions/pt/esbocos/originais/investigar-literatura-lusofona-literateca
We ask that:
- All participants read and be guided by our shared Code of Conduct.
- All participants adhere to our anti-harassment policy:
Política anti-assédio
Esta é uma declaração dos princípios do Programming Historian em português onde são definidas as expectativas para o tom e estilo de toda a comunicação entre revisores, autores, editores e participantes dos nossos fóruns públicos.
Programming Historian em português dedica-se a criar um ambiente académico aberto em que os membros da comunidade podem examinar em liberdade e detalhadamente ideias, fazer perguntas, sugestões ou pedir esclarecimentos. Este espaço tem que ser livre de assédio para todos no projeto, independentemente do género, identidade e expressão de género, orientação sexual, deficiência, aparência física, raça, idade ou religião ou experiência técnica. Não é tolerado de nenhuma forma qualquer assédio ou ataque ad hominem a membros da comunidade. Os membros que violarem estas regras podem ser expulsos da comunidade, por avaliação do conselho editorial. Se alguém testemunhar ou sentir que foi vítima das atividades descritas acima, deve entrar em contato com o nosso mediador independente Luis Ferla. Obrigado por nos ajudar a criar um espaço seguro.
Boa tarde, gente!
Informo que @LFreitas27 e @suemi-higuchi aceitaram ser as revisoras da lição inédita proposta pela @dianamsmpsantos
Coloco aqui as Diretrizes para revisores.
Podem incluir suas revisões e sugestões em um comentário aqui na issue, de preferência utilizando tasklist (- [ ]), e indicando a linha do markdown.
Os arquivos referentes à lição podem ser acessados nos seguintes links:
- arquivo md: /pt/esbocos/originais/investigar-literatura-lusofona-literateca.md
- images: /images/investigar-literatura-lusofona-literateca
- assets: /assets/investigar-literatura-lusofona-literateca
- pré-visualização da lição: http://programminghistorian.github.io/ph-submissions/pt/esbocos/originais/investigar-literatura-lusofona-literateca
Qualquer dúvida é só me marcar por aqui.
Agradeço a colaboração dos colegas e à contribuição inédita da @dianamsmpsantos.
Muito obrigada pelo convite, @ericbrasiln ! Será um prazer contribuir com a revisão desta lição! :)
Olá, prezados!
Primeiramente, gostaria de agradecer a oportunidade de participar como revisora desta lição. É um prazer poder contribuir com o Programming Historian.
Em relação à lição, acredito que a explicação está boa e os exemplos fornecidos ajudam a compreender o conteúdo. No entanto, aponto a necessidade de alguns ajustes em certas construções frasais, pontuação e vocabulário, como, por exemplo, a mudança da palavra “interrogar”, no parágrafo 7, pela palavra “examinar”.
No parágrafo 5, o seguinte trecho “O AC/DC é um projeto já antigo cujo objetivo era tornar disponíveis corpos para o português. Na presente lição vamos simplesmente usar o corpo Literateca, que contém mais de 900 obras escritas por mais de 280 escritores lusófonos.”
poderia ser reescrito da seguinte forma, tornando-o mais fluido: “O AC/DC é um projeto antigo cujo objetivo é tornar disponíveis corpos para o português. Nesta lição, vamos utilizar apenas o corpo Literateca, que contém mais de 900 obras escritas por mais de 280 escritores de língua portuguesa.”
Já os parágrafos 8 e 9 poderiam ser reescritos da seguinte forma: “Ao criar um corpo, define-se um conjunto de atributos que cada unidade (palavra, número ou sinal de pontuação) possui. Durante a anotação, esses atributos são preenchidos com valores, que depois entram nas pesquisas.” “O primeiro atributo é a própria unidade; em seguida, temos atributos morfossintáticos (por exemplo, o lema, a categoria gramatical, o género morfológico), semânticos (o campo semântico a que pertence, o grupo a que pertence) e extralinguísticos (o autor, o sexo do autor, a data de publicação, a variedade do português).”
São pequenos ajustes que, na minha opinião, tornarão a leitura mais fluida. Se estiverem de acordo, posso indicar mais sugestões como essas, porém necessitaria de mais tempo já que se trataria de uma revisão mais atenta. Nesse sentido, se for possível, gostaria de saber se eu poderia entregar essa revisão mais completa até Janeiro.
Desejo boas festas a todos!
Feliz Ano Novo, @LFreitas27 y @suemi-higuchi!
We're absolutely delighted that you're willing to participate in our open peer review process.
We encourage you to read our Diretrizes para Revisores, which provide an outline of the elements we'd like you to keep in mind when you are working through this original lesson and testing the code. If you can focus your feedback on the key areas outlined here, it will help the author to shape the draft to be a practical and sustainable learning resource for the whole community.
With many thanks, Anisa
Parabéns à Diana pelo excelente trabalho! A lição é muito interessante e evidencia as múltiplas possibilidades de pesquisa em leitura distante, utilizando um recurso valioso em português: a Literateca. Apresento abaixo minhas sugestões, que não diminuem em nada a qualidade do trabalho. Para testar os códigos, utilizei o RStudio com a versão mais recente instalada.
- [ ] Linha 26: Retirar a seção "Objetivos" que encontra-se vazia.
Na seção "Introdução":
- [ ] Linha 31: inserir vírgula em "por exemplo,";
- [ ] Linha 31: substituir "com vários" por "por meio de vários";
- [ ] Linha 33: substituir "tem de" por "é preciso";
- [ ] Linha 33: ao invés de "folhas de registo", usar o termo original "dataframes" ou utilizar outra tradução, talvez "tabela de dados"?
Na seção "Apresentação do AC/DC":
- [ ] Que tal mencionar aqui, de forma breve, a Linguateca também? Pois é um centro de recursos valiosíssimo que integra, além do AC/DC, outros projetos úteis para a comunidade de PLN (https://www.linguateca.pt/).
- [ ] Linha 52: inserir vírgula no segundo "neste caso,";
- [ ] Linha 52: substituir "e classificado (o que se chama geralmente metadata)" por "e organizado por metadados";
- [ ] Linha 52: substituir "são anotados" por "são processados";
- [ ] Linha 52: substituir "e também são objeto de mais anotação" por "e enriquecidos com anotação";
- [ ] Linha 52: substituir "foram também descritos" por "são também apresentados";
- [ ] Linha 58: substituir "e durante a anotação," por "e no processo de anotação pelo parser,";
- [ ] Linha 58: substituir "entram nas pesquisas." por "servirão como critérios de procura.";
- [ ] Linha 60: substituir "depois" por "em seguida";
- [ ] Linha 71 (legenda): sugiro complementar a explicação "com quatro atributos: word, lema, pos e temcagr (este último pode indicar tempo verbal, caso para pronomes e grau)";
- [ ] Linha 71: substituir "Na realidade, a Literateca tem 27 atributos." por "A Literateca define 27 atributos no total.";
- [ ] Linha 78: substituir "eu posso" por "é possível";
- [ ] Linha 80 (legenda): substituir "Pesquisa pedindo uma concordância (apenas 4 dos 4889 resultados da pesquisa pela palavra 'cara')" por "Pesquisa de concordância exibindo 4 dos 4889 resultados para a palavra ‘cara’";
- [ ] Linha 82 (legenda): substituir "pedindo" por "exibindo";
- [ ] Linha 84 (legenda): substituir "pedindo" por "exibindo";
- [ ] Linha 88: substituir "não permite apenas procurar por palavras, é possível procurar" por "além de buscar por palavras, permite pesquisar";
- [ ] Linha 92: substituir "acabados" por "que terminem em";
- [ ] Linha 105 (legenda): substituir "Quais as distribuições" por "As distribuições";
- [ ] Linha 109: incluir "sobre" em "Para saber sobre as obras...";
- [ ] Entre as linhas 115 e 117: sugiro incluir a tela inicial do Distribuidor, talvez com o exemplo que é mencionado logo em seguida, para ilustrar;
- [ ] Linha 125: incluir após tsv (Tab-Separated Values)";
- [ ] Linha 125: complementar "obtém-se um ficheiro com dados tabulares que...";
- [ ] Linha 125: substituir "sobre roupa," por "sobre a exploração do vestuário na literatura em português,";
- [ ] Linha 143: complementar "As próximas colunas, relativas à frequência parcial, não são relevantes";
- [ ] Linha 145: substituir "ter" por "obter";
- [ ] Linha 145: subsituir "por exemplo:" por "assim:";
- [ ] Linha 153: substituir "essa obras" por "essas obras";
- [ ] Linha 155: substituir "para UTF-8" por "para o formato UTF-8";
Na seção "O uso da linguagem R"
- [ ] Linha 159: substituir "incluir" por "importar";
- [ ] Linha 163: sugiro incluir ao final algo como "Copie o código a seguir para o seu ambiente de programação R e execute-o, lembrando de configurar o diretório de trabalho para o local em que se encontra o ficheiro distribuicaoObra.tsv.";
- [ ] No R: ao executar o código, o comando read.table trouxe erros na leitura dos dois tsv (error in scan file), e só funcionou depois que eu forcei a conversão dos arquivos para ANSI (e não UTF-8). Pode checar, Diana?
- [ ] Linha 176: substituir "nas duas folhas" por "das duas folhas";
- [ ] No R: o que seria a coluna “tamanho” que consta no dataframe 'obras'? Número de tokens de cada obra? No cálculo da frequência relativa encontramos “número de unidades”, então talvez seja bom explicitar o que seriam essas ‘unidades’;
- [ ] No R: no dataframe ‘roupa’, sugiro substituir o nome da coluna “roupa” por “mencoes”, ou algo do tipo. Acho que ficaria mais intuitivo para o usuário compreender a sexta linha do código;
- [ ] No R: por que as seguintes 5 obras não existem no dataframe ‘obras’? Auto_dos_Quatro_Tempos, Itinerário_da_Viagem_que_Fez_a_Jerusalém_o_M.R.P., Textos_varios_Parte_1, Textos_varios_Parte_2, Vida_de_Takla_Haymanot;
- [ ] Linha 178: o final do parágrafo diz "neste caso para dez autores que têm várias obras na Literateca". Como se chegou a esses dez autores?
- [ ] Linha 193: dependendo do nível a ser atribuído a esta lição, fica a sugestão de explicar o porquê da conclusão apresentada nesse parágrafo, a partir da diferença de posicionamento dos dois autores no gráfico (muitos usuários não sabem ler um boxplot);
- [ ] Linha 195: sugiro complementar o parágrafo mencionando um ou dois insights breves da figura/gráfico 7, apenas para ilustrar e justificar sua presença;
- [ ] Linha 216: substituir "dos casos de aparência (no caso das obras literárias em prosa)" por "dos casos de aparência, selecionando apenas as obras literárias em prosa";
- [ ] Linha 222: substituir "(também no caso das obras literárias em prosa)" por "(também selecionando as obras literárias em prosa)";
- [ ] Linha 262: O arquivo distribuicaoCidadesObra.tsv não existe na pasta assets da lição;
- [ ] Entre as linhas 268 e 269: faltou uma quebra de linha;
- [ ] Linha 279, o trecho
names(locais)<-c("tipo","lixo","obra","autor","num","lixo2")está dando erro no R, pois o número de colunas está divergindo. Tentei adivinhar colocando assim:names(locais)<-c("obra","num","autor","lixo1","lixo2"). Está correto? - [ ] Linha 290: é apresentada a explicação da sétima linha do código. Este comando significaria “somar os valores de localrel para cada obra”? Eu fiquei na dúvida porque me parece que as obras não aparecem mais de uma vez na lista. Estou errada?
- [ ] Linha 294: sobre o gráfico. Continuando o item acima, aquele código fez com que a ordenação do gráfico resultante esteja diferente do ranking apresentado em localrel, e por isso não consegui descobrir a lógica do porquê a “A_Brasileira_de_Prazins” aparecer antes de “Os_Caramurús:_romance_histórico_da_descoberta_e_independência_do_Brasil” e também de “A_Relíquia” (dentre tantos outros exemplos que observei);
- [ ] Linha 300: Esta subseção me atraiu pelo título e esperei encontrar alguns exercícios e exemplos da mesma forma como nas seções anteriores. Infelizmente não consegui localizar a tese do Marcus na Internet. Caso o objetivo da seção seja apenas mencionar o estudo para divulgá-lo, sugiro um link de download direto para o trabalho e também uma imagem ou gráfico (antes do último parágrafo) que ilustre algum resultado dessa pesquisa para que possamos ter uma ideia das possibilidades e também justifique a presença na lição;
- [ ] Linha 304: substituir "O trabalho dele" por "Seu trabalho";
- [ ] Linha 306: substituir o texto por "No processo, recebemos um conjunto de lexemas que, segundo o autor, estavam associados à cultura grega, e anotamos o OBras, o principal corpus de literatura brasileira no AC/DC, com essa informação (a marcação helen). Isso facilitou a medição do peso dessas palavras em um conjunto de autores brasileiros com obras no OBras".
Na seção "Observações finais"
- [ ] Linha 314: substituir "várias potencialidades do estudo" por "diversas possibilidades de estudo";
- [ ] Linha 314: substituir "através da leitura distante" por "por meio da leitura distante";
- [ ] Linha 314: substituir "contém textos" por "reúne textos";
Uma última observação: talvez a lição vá além do que sugere a expressão "através dos tempos" do título provisório. :)
Espero que minhas sugestões e comentários tenham sido úteis. Mais uma vez, parabéns à Diana pela originalidade e pela excelente contribuição à comunidade do Programming Historian. Agradeço a confiança e permaneço à disposição para dúvidas ou novos feedbacks.