Documentation Revamp / Organisation
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Facilidade para iniciantes
- 20/100
- Tipo de issue
- Refatoração
- Clareza
- Precisa de esclarecimento
- Status de atividade
- Estagnada
- Stack de tecnologia
- java
- Domínio
- build-system, developer-experience, documentation
Direção de pesquisa
Comece lendo a issue relacionada #1204 e mapeando como processing-website, processing-doclet, processing-examples, processing4 e processing4-javadocs atualmente trocam conteúdo gerado. Revise as etapas existentes de build e release antes de escolher um caminho de migração. Considera-se concluído quando os repositórios não exigirem mais colocação manual no mesmo local nem cópias somente leitura, e as ações documentadas de geração e atualização estiverem automatizadas ou consolidadas.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
The examples and some of the documentation around Processing are kind of all over the place
The Goal
Have one repo where documentation lives: processing-website
The current issues
- processing-website
- updates processing4's
keywords.txtbased on content generated through processing-doclet - has to manually update
content/examplesand it is unclear that this data is partially read-only, the script applies processing-examples on top -
content/contributionsis also readonly and is no longer compatible with the new processing-contributions pipeline
- updates processing4's
- processing4-javadocs does not automatically update with each release
- processing-examples does not contain the images/livesketches/metadata that the website needs.
- processing-doclet is a separate repo that will create the parsed javadoc comments for the website
Suggested actions
- Get rid of any instances where the developer has to make sure repositories live next to each other on disk
- Migrate
processing-docletinto theprocessing-websiteand make it run on build- Research further into migrating / replicating the custom doclet into Gradle and make it run w gradle
- Delete
processing-docletrepo - Migrate
processing-examplesinto theprocessing-website- Tested, still need to figure out how to merge the folders whilst keeping history
- Archive
processing-examples - Remove all read-only files from
processing-website - Move the generation of
keywords.txtback into theprocessing4repo - Add an automatic update trigger for
processing4-javadocto theprocessing4repo release action (or migrateprocessing4-javadocinto theprocessing4repo)- Migrate Javadoc from Ant to Gradle
Related PRs/Issues/Other documentation
#1204
- Linguagem predominante
- Java
- Estrelas
- 497
- Forks
- 183
- Merge médio
- 4h 39min
- PRs com merge (30d)
- 3
Preparar o ambiente
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de processing/processing4
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 64/100
processing/processing4#1554 · 1 comentário ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
processing/processing4#1515 · 1 reação ·
-
bug
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 55/100
processing/processing4#1573 · 1 comentário ·
-
startup errorAberta
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 25/100
processing/processing4#1569 · 7 comentários ·
-
Binaries under bin directory lack executable permissions for the snap and .deb packages for LinuxTalvez já em andamento @catilac assumiu há 9 dias. Abertabug
processing/processing4#1567 · 3 comentários · 1 reação · 1 responsável ·
Todas as issues de processing/processing4
Issues semelhantes
-
and-bugs and-ui gpx-track
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 86/100
Mantenedores costumam responder em até 2 dias
-
TerminalRow.mSpaceUsed (short) overflows on terminals wider than 1023 columns, crashing setCharAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100
termux/termux-app#5340 ·
Mantenedores costumam responder em até 1 dia
-
OpenAICompatibleToolDescriptorSchemaGenerator drops requiredProperties of nested object parametersAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
Mantenedores costumam responder em até 7 dias
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 86/100
apache/rocketmq-dashboard#5110 ·
Mantenedores costumam responder em até 1 dia
-
frontend
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100
No-Country-simulation/S08-26-equipo04#210 ·
Mantenedores costumam responder em até 1 dia