search

programminghistorian / ph-submissions

The repository and website hosting the peer review process for new Programming Historian lessons
http://programminghistorian.github.io/ph-submissions
138 stars 114 forks source link

Sumarização de narrativas acerca de eventos do passado documentados na web utilizando Python: o caso do Arquivo.pt (PH/JISC/TNA) #420

Closed tiagosousagarcia closed 1 year ago

tiagosousagarcia commented 3 years ago

O Programming Historian em Português recebeu a seguinte lição: "Sumarização de narrativas acerca de eventos do passado documentados na web utilizando Python: o caso do Arquivo.pt", por @rncampos and @dcgomes.

A lição traduzida está no link a seguir: https://github.com/programminghistorian/ph-submissions/blob/gh-pages/pt/esbocos/originais/sumarizacao-narrativas-web-python.md

Esta lição está agora em revisão e pode ser lida em: http://programminghistorian.github.io/ph-submissions/pt/esbocos/originais/sumarizacao-narrativas-web-python

As imagens estão na pasta https://github.com/programminghistorian/ph-submissions/tree/gh-pages/images/sumarizacao-narrativas-web-python

Até que um editor seja atribuído, eu servirei como editor temporário.

Peço para avaliarem a lição, assim como se há necessidade de adequação de dados ou algum conteúdo. Por favor, deixem suas sugestões neste ticket. Para cada modificação a ser sugerida, por favor, peço para indicar as linhas do ficheiro de maneira que facilite os ajustes. O ideal é realizar as modificações após as sugestões dos dois revisores.

Todos os membros da comunidade estão convidados a oferecer feedback construtivo que deve ser publicado neste canal, mas é solicitado que leiam primeiro as diretrizes para revisores (/directrizes-revisor) e sigam a nossa política anti-assédio (abaixo). Pedimos que todas as revisões parem após o envio da segunda revisão formal para que o/a autor/tradutor(a) possa concentrar-se no ajuste da lição. Eu farei um anúncio neste tópico quando isso ocorrer.

Vou me esforçar para manter a conversa aberta aqui no GitHub, mas se alguém sentir a necessidade de discutir algo em particular, pode entrar em contato comigo, ou pode sempre recorrer para o nosso mediador independente se achar necessário.

Se houver alguma preocupação dos autores, eles podem entrar em contato com o mediador do PH em português (Luís Ferla).

tiagosousagarcia commented 2 years ago

@DanielAlvesLABDH -- alterei o ticket para indicar que a lição foi submetida. Desculpa se alguma coisa nao está como devia

tiagosousagarcia commented 2 years ago

@rncampos e @dcgomes -- o commit acima (fc32699) inclui as pequenas alteracoes que fiz ao vosso artigo durante a revisao técnica. mais uma vez os meus parabéns pelo excelente trabalho. O resumo das alteracoes é o seguinte:

Alteracoes feitas

Uma pequena nota sobre a remocao dos vídeos embebidos -- por norma, nao costumamos publicar vídeos no corpo da licao, e evitamos que estes sejam fulcrais (por razoes de sustabilidade). Por isso troquei os vídeos por links externos.

Duas pequenas alteracoes que merecem a vossa atencao:

Alteracoes sugeridas

rncampos commented 2 years ago

Olá Tiago,

Obrigado pelas alterações.

Relativamente à tua primeira questão. Na verdade é mesmo ao git que nos referimos. O Conta-me Histórias não se encontra no pypi (por uma questão de licenças) pelo que a instalação tem que ser feita via git como referido no tutorial. Quanto à tua questão das versões utilizadas. No caso da versão anaconda local o python usado é Python 3.6. 5 No caso do google colab foi a Python 3.6. 9

Achas que podes adicionar uma mensagem relativa a isto (para ficar desde já de acordo com o que pretendes)?

Abraço

De: tiagosousagarcia @.> Enviada: 18 de janeiro de 2022 11:18 Para: programminghistorian/ph-submissions @.> Cc: Ricardo Campos @.>; Mention @.> Assunto: Re: [programminghistorian/ph-submissions] Sumarização de narrativas acerca de eventos do passado documentados na web utilizando Python: o caso do Arquivo.pt (PH/JISC/TNA) (Issue #420)

@rncamposhttps://github.com/rncampos e @dcgomeshttps://github.com/dcgomes -- o commit acima (fc32699https://github.com/programminghistorian/ph-submissions/commit/fc32699119143ce6b468b8404f6889123ea00b83) inclui as pequenas alteracoes que fiz ao vosso artigo durante a revisao técnica. mais uma vez os meus parabéns pelo excelente trabalho. O resumo das alteracoes é o seguinte:

Alteracoes feitas

Uma pequena nota sobre a remocao dos vídeos embebidos -- por norma, nao costumamos publicar vídeos no corpo da licao, e evitamos que estes sejam fulcrais (por razoes de sustabilidade). Por isso troquei os vídeos por links externos.

Duas pequenas alteracoes que merecem a vossa atencao:

Alteracoes sugeridas

— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/420#issuecomment-1015313447, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AEMYCXXPECSWEPTNNGUJ6TTUWVD43ANCNFSM5HGZAR3Q. Triage notifications on the go with GitHub Mobile for iOShttps://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Androidhttps://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub. You are receiving this because you were mentioned.Message ID: @.***>

DanielAlvesLABDH commented 2 years ago

Caros colegas, caro @tiagosousagarcia, o @josircg aceitou ficar como Editor para esta lição. Agradeço a sua disponibilidade e desejo que o trabalho de revisão corra bem. Se for necessária alguma ajuda da minha parte estou disponível. Abraço a todos

josircg commented 2 years ago

Olá @tiagosousagarcia e @rncampos. Ainda essa semana vou testar o código e as considerações levantadas pelo revisor. @DanielAlvesLABDH teremos apenas um revisor para este tutorial?

DanielAlvesLABDH commented 2 years ago

Foram convidados dois @josircg. Estamos a aguardar

DanielaMajor commented 2 years ago

Alguns reparos:

tiagosousagarcia commented 2 years ago

Muito obrigado pela revisão, @DanielaMajor!

@rncampos e @dcgomes, ainda esperamos uma outra revisão -- quando chegar, o @josircg vai fazer um sumário dos pontos mais importantes

JimmyMedeiros82 commented 2 years ago

@josircg estou passando por todas as issues do PHpt e avaliando o andamento das atividades. Esta lição está pronta para seguir para publicação?

josircg commented 2 years ago

Ainda não Jimmy. Estamos precisando de um outro revisor que não estamos encontrando. Não tem ninguém aí da FGV que possa pegar essa revisão?

JimmyMedeiros82 commented 2 years ago

será que a @daniellesanchesDH topa colaborar com esta atividade?

tiagosousagarcia commented 2 years ago

Olá a todos! Só uma pequena nota para dizer que esta é a minha última semana a trabalhar com o PH. Foi um prazer enorme trabalhar nesta lição, e só tenho pena de não estar presente na sua publicação! Muito obrigado aos autores, @rncampos e @dcgomes pela excelente lição, e ao @josircg pelo trabalho editorial!

DanielAlvesLABDH commented 1 year ago

Caros, as minhas desculpas pelo longo silêncio. Estou a procurar alguém para fazer a segunda revisão desta lição. Assim que tiver novidades indico aqui. Espero que agora possamos avançar mais rápido. Obrigado a todos pela paciência!

DanielAlvesLABDH commented 1 year ago

Olá de novo. A Salete Farias @saletefarias aceitou fazer a segunda revisão desta lição. Agradeço muito uma vez mais a sua generosidade e profissionalismo.

saletefarias commented 1 year ago

Prezados, é uma alegria poder contribuir mais um vez com o Programming Historian. Obrigada @DanielAlvesLABDH novamente pelo convite. Enquanto revisava a lição, testei a instalação das bibliotecas e executei todos os códigos apresentados, utilizei o Colab do Google (uma das plataformas recomendadas pela lição) e tudo funcionou perfeitamente, inclusive aproveito para dizer que gostei imenso dessa lição e dos projetos arquivo.pt e Conta-me Histórias. A seguir minhas sugestões de alteração, por linha:

Estas são as minhas observações e sugestões. Abraços Salete Farias

DanielAlvesLABDH commented 1 year ago

Muito obrigado pela revisão e pela rapidez na resposta @saletefarias. Excelente! Tendo isto em conta, caros @rncampos e @dcgomes temos tudo pronto para que possam fazer uma revisão da vossa proposta. @josircg não sei se tens algo mais a acrescentar?

rncampos commented 1 year ago

Olá Daniel, Já procedi às alterações indicadas pela Salete (a quem agradeço os comentários)

DanielAlvesLABDH commented 1 year ago

Muito obrigado @rncampos! @josircg quer fazer uma última revisão antes de avançarmos?

josircg commented 1 year ago

Nada a acrescentar. A revisão ficou ótima!

DanielAlvesLABDH commented 1 year ago

Obrigado @josircg. Sendo assim vou fazer uma última leitura e os ajustes necessários à publicação. Obrigado a todos/as!

DanielAlvesLABDH commented 1 year ago

Caros, comecei a rever o texto e verifiquei que não surgem algumas das revisões sugeridas pela Daniela. @rncampos pode confirmar, por favor, por exemplo:

Não me parece que tenham feito estas alterações e acho que são relevantes.

Outra questão relativa às imagens. A política de acessibilidade do Programming Historian foi actualizada e temos um conjunto de recomendações relativas às imagens, nomeadamente a inclusão de texto "alt". Ricardo, por favor, veja estas recomendações (https://github.com/programminghistorian/jekyll/wiki/Achieving-Accessibility-Alt-text-Colour-Contrast) e introduza os respectivos "alt" no link de acesso às imagens da lição, por favor.

rncampos commented 1 year ago

Olá Daniel Alves,

Já encaminhei para o Daniel Gomes.

Cumprimentos Ricardo Campos

De: Daniel Alves @.> Enviada: 25 de novembro de 2022 14:16 Para: programminghistorian/ph-submissions @.> Cc: Ricardo Campos @.>; Mention @.> Assunto: Re: [programminghistorian/ph-submissions] Sumarização de narrativas acerca de eventos do passado documentados na web utilizando Python: o caso do Arquivo.pt (PH/JISC/TNA) (Issue #420)

Caros, comecei a rever o texto e verifiquei que não surgem algumas das revisões sugeridas pela Daniela. @rncamposhttps://github.com/rncampos pode confirmar, por favor, por exemplo:

Não me parece que tenham feito estas alterações e acho que são relevantes.

Outra questão relativa às imagens. A política de acessibilidade do Programming Historian foi actualizada e temos um conjunto de recomendações relativas às imagens, nomeadamente a inclusão de texto "alt". Ricardo, por favor, veja estas recomendações (https://github.com/programminghistorian/jekyll/wiki/Achieving-Accessibility-Alt-text-Colour-Contrast) e introduza os respectivos "alt" no link de acesso às imagens da lição, por favor.

— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/420#issuecomment-1327524530, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AEMYCXXHN4HNGFCFULUCHZLWKDCYJANCNFSM5HGZAR3Q. You are receiving this because you were mentioned.Message ID: @.***>

dcgomes commented 1 year ago

Olá, Fiz as alterações sugeridas pela Daniela Major. Falta mais alguma acção da minha parte. Abraços.

From: Daniel Alves @.***> Sent: Friday, 25 November 2022 14:15 To: programminghistorian/ph-submissions Cc: Daniel Gomes; Mention Subject: Re: [programminghistorian/ph-submissions] Sumarização de narrativas acerca de eventos do passado documentados na web utilizando Python: o caso do Arquivo.pt (PH/JISC/TNA) (Issue #420)

Caros, comecei a rever o texto e verifiquei que não surgem algumas das revisões sugeridas pela Daniela. @rncamposhttps://github.com/rncampos pode confirmar, por favor, por exemplo:

Não me parece que tenham feito estas alterações e acho que são relevantes.

Outra questão relativa às imagens. A política de acessibilidade do Programming Historian foi actualizada e temos um conjunto de recomendações relativas às imagens, nomeadamente a inclusão de texto "alt". Ricardo, por favor, veja estas recomendações (https://github.com/programminghistorian/jekyll/wiki/Achieving-Accessibility-Alt-text-Colour-Contrast) e introduza os respectivos "alt" no link de acesso às imagens da lição, por favor.

— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/420#issuecomment-1327524530, or unsubscribehttps://github.com/notifications/unsubscribe-auth/ADEDGYCTZB2TYUDOEVBUYKDWKDCYJANCNFSM5HGZAR3Q. You are receiving this because you were mentioned.Message ID: @.***>

DanielAlvesLABDH commented 1 year ago

@dcgomes acho que não tinhas acesso ao repositório. Não vejo as alterações feitas no documento: https://github.com/programminghistorian/ph-submissions/blob/gh-pages/pt/licoes/originais/sumarizacao-narrativas-web-python.md

DanielAlvesLABDH commented 1 year ago

Obrigado pelas edições @dcgomes. Vou concluir a revisão do texto e depois dou feedback!

DanielAlvesLABDH commented 1 year ago

Caros, fiz uma revisão geral e ainda faltam algumas coisas antes de podermos avançar para a publicação. Ao @rncampos e ao @dcgomes:

Ao @josircg:

Agradeço uma vez mais toda a vossa colaboração. Já falta pouco!

anisa-hawes commented 1 year ago

Hello all,

Please note that as part of a reorganisation of the /pt directory, this lesson's .md file has been moved to a new location within our Submissions Repository.

It is now found here: https://github.com/programminghistorian/ph-submissions/blob/gh-pages/pt/esbocos/originais/sumarizacao-narrativas-web-python.md

A consequence is that this lesson's preview link has changed. It is now: http://programminghistorian.github.io/ph-submissions/pt/esbocos/originais/sumarizacao-narrativas-web-python

Please let me know if you encounter any difficulties or have any questions. Very best, Anisa

rncampos commented 1 year ago

Hi to all. I have just created a pull request with the required changes

As for the image we suggest you could use the one that is part of the lesson: sumarizacao-narrativas-web-python-1.jpg

Best Ricardo and Daniel

josircg commented 1 year ago

Olá Ricardo e Daniel,

1) seguem minhas sugestões para o campos Dificulty, Activity e Topics:

para o campo Dificulty: 2 (Medium) para o campo Activity: Transform para o campo Topic: api, python, data-manipulation

2) um pequeno detalhe: ficou um parênteses a mais no link js_json_intro.asp

Rodei todos os scripts para ver se tenho algo mais a acrescentar. Não sei se vale a pena indicar isso no texto final mas tudo rodou perfeitamente com python 3.8

Parabéns mais uma vez pelo conteúdo. Está muito bom e muito didático!

rncampos commented 1 year ago

Olá José. Ok do nosso lado. Relativamente ao ponto dois não sei se é possível alterares do teu lado (não sei muito bem o que é isso a que te referes). Obrigado Ricardo

josircg commented 1 year ago

Olá Ricardo, eu, como editor, devo apenas indicar os ajustes para os autores. E, a partir das minhas sugestões, vocês devem alterar o texto caso achem as sugestões pertinentes.

DanielAlvesLABDH commented 1 year ago

Coloquei o resumo no campo abstract do cabeçalho e eliminei o ")" a mais no link do json. A imagem sugerida pelo @rncampos não pode ser usada. Tem de ser uma imagem a preto e branco, quadrada, com aspecto de gravura, similar às usadas nas outras lições. Vou procurar uma

DanielAlvesLABDH commented 1 year ago

@rncampos @dcgomes e @josircg vejam, por favor, o que acham desta imagem para ilustrar a lição? reino_do_algarve_1730_p b Original aqui: https://www.loc.gov/resource/g6693a.ct000254/

josircg commented 1 year ago

Oi @DanielAlvesLABDH, a gente como editor pode ajustar o texto diretamente ? Pensei que tinhamos que seguir as mesmas regras dos revisores.

DanielAlvesLABDH commented 1 year ago

Olá @josircg, na fase de revisão final e em casos de pequenas correcções, como era o caso desta, eu tenho feito directamente. Se forem alterações substanciais de texto, do sentido das frases ou de correcções de código então ficam para os autores. O que achou da imagem? Tem outras sugestões? É algo que também cabe aos editores (https://programminghistorian.org/pt/directrizes-editor#4-encontrar-uma-imagem-para-representar-a-li%C3%A7%C3%A3o) embora se possa pedir aos autores também.

DanielAlvesLABDH commented 1 year ago

para o campo Dificulty: 2 (Medium)

Olá @josircg , na reunião dos editores-chefe discutimos um conjunto de critérios para a definição do nível de dificuldade das lições. Achas que podes verificar aqui (https://github.com/programminghistorian/jekyll/issues/2325) e ver se isso é útil e se é coerente com a tua sugestão para esta lição? Era uma boa ajuda para nós definirmos uma política mais geral. Obrigado!

josircg commented 1 year ago

Procurei muito essa definição dos tipos de dificuldade :( Acho que ela poderia ir para a página principal que detalha as tarefas dos editores (https://programminghistorian.org/pt/directrizes-editor)

Sobre a categorização específica para este artigo: mantenho como (2) intermediário - porque existem conceitos de python e API que não são para iniciantes mas não seria o (3) porque o artigo não se encaixa em nenhum dos critérios indicados nas diretrizes.

DanielAlvesLABDH commented 1 year ago

Obrigado pelo contributo @josircg . Esses critérios ainda estão a ser discutidos pelo que se quiser 9ncluir lá este comentário é uma óptima ajuda.

anisa-hawes commented 1 year ago

Hello @josircg.

As Daniel explains, we are in the process of clarifying the criteria for assigning lesson difficulty at the moment. Do let us know if you have found some useful criteria elsewhere? Or if there are other aspects you'd like us to consider?

Thank you, Anisa

DanielAlvesLABDH commented 1 year ago

@rncampos @dcgomes e @josircg vejam, por favor, o que acham desta imagem para ilustrar a lição? reino_do_algarve_1730_p b Original aqui: https://www.loc.gov/resource/g6693a.ct000254/

Caros @dcgomes, @rncampos e @josircg o que acham da escolha desta imagem? Têm outra sugestão?

josircg commented 1 year ago

Eu achei ótima. Eu andei procurando uma que falasse sobre jornalismo e portugal mas não achei nada que fosse de acesso aberto.

rncampos commented 1 year ago

Olá Daniel. Andei à procura de outra imagem que relacionasse mais os dois tópicos discutidos (arquivos da web e timelines), mas não é fácil encontrar algo com essas características (e que esteja em cumprimento com as vossas diretivas). Por essa razão, julgo que é melhor avançarmos com esta para que a lição seja finalmente publicada. Obrigado Ricardo

DanielAlvesLABDH commented 1 year ago

Obrigado a todos! Sendo assim, logo que possível vou iniciar o processo de publicação. Abraço e Boas Festas

dcgomes commented 1 year ago

A imagem de um mapa do Reino do Algarve não tem nada a ver com a lição e pode induzir os leitores em erro. Uma imagem do ContaMeHistorias.pt faz mais sentido:

image

DanielAlvesLABDH commented 1 year ago

Olá @dcgomes eu percebo que faça mais sentido, mas não é esse tipo de imagem que está associado às lições que são publicadas no site e nesse sentido aquela é a que está mais próxima de "Portugal". A linha gráfica do Programming Historian tem optado por imagens de gravuras ou mapas históricos. Se encontrarem uma gravura naqueles tons que faça mais sentido, eu aceito. Eu ainda gastei algum tempo a procurar e não encontrei. Abraço

DanielAlvesLABDH commented 1 year ago

Olá a todos. Fiz mais umas pesquisas de imagens. Vejam o que vos parece esta hipótese, tirada daqui: https://purl.pt/25621/1/index.html#/23/html

portugal

anisa-hawes commented 1 year ago

Dear @DanielAlvesLABDH. As this is an original lesson, we have allocated budget for it to be copyedited ahead of publication. @joanacvp will be the copyeditor. After that, I will check the typesetting and replace live external links with archival Perma.cc links.

DanielAlvesLABDH commented 1 year ago

Thank you @anisa-hawes. Apart from the choice of the image the lesson is ready. Happy Holidays

rncampos commented 1 year ago

Olá Daniel. Para ser honesto não sou muito apreciador de nenhuma das imagens, mas se essas são as vossas diretrizes e se falta apenas isto para a lição ficar concluída, acho que é de seguir. Boas festas Ricardo

DanielAlvesLABDH commented 1 year ago

Olá @rncampos. Temos efectivamente uma política de harmonização do tipo de imagens para ilustrar as lições. Vejam aqui: https://programminghistorian.org/pt/directrizes-editor#4-encontrar-uma-imagem-para-representar-a-li%C3%A7%C3%A3o

Fiz mais umas pesquisas e encontrei este "contador de histórias" na Biblioteca Nacional de França (https://gallica.bnf.fr/ark:/12148/btv1b103199706.r=conteur%20histoires?rk=42918;4). Deixo aqui um detalhe que pode servir de imagem para a lição.

Dollingue_le_Conteur_d_histoires