aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2024-09-14 13:46:43 -0300
committerSilvio Rhatto <rhatto@riseup.net>2024-09-14 13:46:43 -0300
commitae6e83659ecd5775937ba08508c2efb841150994 (patch)
tree6f2a225dc560a8d52e1f16b3875335128422ceeb
parent9203cf1974de8fd44580ee064a85599de93d3ad9 (diff)
downloadtemplates-ae6e83659ecd5775937ba08508c2efb841150994.tar.gz
templates-ae6e83659ecd5775937ba08508c2efb841150994.tar.bz2
Metadados e macros
-rw-r--r--ChangeLog.md8
-rw-r--r--docs/index.en.md24
-rw-r--r--docs/index.md10
-rw-r--r--docs/pessoal/conduta/README.md25
-rw-r--r--docs/pessoal/conduta/anti-assedio.md12
-rw-r--r--docs/pessoal/conduta/debates/README.md4
-rw-r--r--docs/pessoal/conduta/modelos/README.md4
-rw-r--r--docs/pessoal/conduta/modelos/debates/estrito.md (renamed from docs/pessoal/conduta/debates/modelos/estrito.md)14
-rw-r--r--docs/pessoal/conduta/modelos/quadrado.md11
-rw-r--r--docs/todo.md69
-rw-r--r--docs/usando.md12
-rw-r--r--mkdocs.yml34
-rwxr-xr-xscripts/provision2
13 files changed, 165 insertions, 64 deletions
diff --git a/ChangeLog.md b/ChangeLog.md
new file mode 100644
index 0000000..86eb6aa
--- /dev/null
+++ b/ChangeLog.md
@@ -0,0 +1,8 @@
+# ChangeLog
+
+## 2024-09-14 - Reorganização
+
+* [x] Create document macros:
+ * Version.
+ * Original document (if translation, summary etc).
+ * Original document version.
diff --git a/docs/index.en.md b/docs/index.en.md
index 774fcb6..dcd80c8 100644
--- a/docs/index.en.md
+++ b/docs/index.en.md
@@ -1,3 +1,25 @@
# Sociotechnic Protocols
-**Blueprints, boilerplates, models, lists, templates! Ready to use and to organize yourself and your team!**
+## About
+
+**Blueprints, boilerplates, models, lists, templates! Ready to use and to
+organize yourself and your team!**
+
+This is a repository with protocols for personal and collective management.
+
+It has procedures, behaviors and simple rules that can be freely adopted.
+When combined, they may contribute to the sprouting of complex collective
+modes of organization.
+
+They are small machines that increase the flow and organization of social
+groups.
+
+These protocols are mainly maintained in [Portuguese](/), but versions
+in other languages may be available.
+
+## Metadata
+
+* {{ metadata.version.pt }}: `ver:2024-09-14`.
+* {{ metadata.identifier.pt }}: `pid:index_en`.
+* {{ metadata.original_identifier.pt }}: `pid:index`.
+* {{ metadata.original_version.en }} `ver:2024-09-14`.
diff --git a/docs/index.md b/docs/index.md
index b47567a..eb35711 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,5 +1,7 @@
# Protocolos e Procederes Sociotécnicos
+## Sobre
+
**Modelos, listas, templates! Prontos para usar e se organizar!**
Este é um repositório de protocolos de gestão pessoal e coletiva.
@@ -10,4 +12,12 @@ complexos de organização coletiva.
São pequenas máquinas que aumentam a fluidez e a organização de grupos sociais.
+Estes protocolos são mantidos prioritariamente no idioma Português, porém
+versões noutros idiomas podem estar disponíveis, como por exemplo em [Inglês](en).
+
[^emergencia]: Ou _emergência_, no sentido de emergir.
+
+## Metadados
+
+* {{ metadata.version.pt }}: `ver:2024-09-14`.
+* {{ metadata.identifier.pt }}: `pid:index`.
diff --git a/docs/pessoal/conduta/README.md b/docs/pessoal/conduta/README.md
index aab9dd4..93842a2 100644
--- a/docs/pessoal/conduta/README.md
+++ b/docs/pessoal/conduta/README.md
@@ -1,5 +1,14 @@
# Códigos de Conduta Pessoal
+!!! warning "Alerta de gatilhos"
+
+ Esta seção trata de temas sensíveis e que podem causar desconforto.
+
+ Por outro lado, ela contém modelos de proceder cujo objetivo é
+ acabar com violências e desconfortos sociais.
+
+## Introdução
+
Esta seção trata de códigos de conduta pessoal:
* Tanto de Códigos de Conduta pré-estabelecidos em eventos, grupos etc.
@@ -8,7 +17,7 @@ Esta seção trata de códigos de conduta pessoal:
usado em eventos e outras situações onde não haja um Código de Conduta
explícito/definido/conhecido.
-!!! warning "Alerta"
+!!! warning "Alerta de comportamento"
Não é porque um local/evento não possua um código de conduta explícito
que significa que não haja código de conduta.
@@ -26,6 +35,9 @@ Esta seção trata de códigos de conduta pessoal:
## Códigos de Conduta Pré-estabelecidos
+Esta é uma lista incompleta de códigos de conduta pré-estabelecidos para
+participação em organizações e eventos:
+
* [Código de Conduta da CryptoRave](https://we.riseup.net/cryptorave/politica-anti-assedio).
* [Código de Conduta para eventos na MariaLab](https://www.marialab.org/codigo-de-conduta/).
* [Código de Conduta Antiassédio Sexual Intervozes](https://app.rios.org.br/index.php/s/PyLXN85zywLkYBt).
@@ -37,14 +49,3 @@ Esta seção trata de códigos de conduta pessoal:
* [Note Well - IETF](https://www.ietf.org/about/note-well/).
* [Universal Declaration of Human Rights | United Nations](http://www.un.org/en/universal-declaration-human-rights/index.html).
* [Chatham House Rule](https://en.wikipedia.org/wiki/Chatham_House_Rule).
-
-## Prevenção e combate
-
-Cartilhas e manuais anti-assédio e anti-discriminação:
-
-* [Prevenção aos assédios moral e sexual - Capes](https://www.gov.br/capes/pt-br/centrais-de-conteudo/documentos/16102023_Cartilha_de_Preveno_aos_assdios_moral_e_sexual.pdf).
-* [Assédio moral no trabalho: perguntas e respostas - MPT](https://mpt.mp.br/pgt/publicacoes/cartilhas/assedio-moral-no-trabalho-perguntas-e-respostas/@@display-file/arquivo_pdf).
-* [Assédio moral e sexual - Previna-se - CNMP](https://www.mpf.mp.br/sc/arquivos/cartilha-assedio)
- ([cópia](https://www.cnmp.mp.br/portal/publicacoes/245-cartilhas-e-manuais/9982-assedio-moral-e-sexual-previna-se)).
-* [Manual sobre a prevenção e o enfrentamento ao assédio moral e sexual e à discriminação](https://mpt.mp.br/pgt/publicacoes/manuais/manual-sobre-a-prevencao-e-o-enfrentamento-ao-assedio-moral-e-sexual-e-a-discriminacao/@@display-file/arquivo_pdf).
-* [Assédio Moral, Sexual e Discriminação Saiba mais sobre essas distorções de conduta no ambiente de trabalho](https://biblioteca.mpf.mp.br/server/api/core/bitstreams/a7da884c-fefb-4641-a301-a22abeb93824/content).
diff --git a/docs/pessoal/conduta/anti-assedio.md b/docs/pessoal/conduta/anti-assedio.md
new file mode 100644
index 0000000..bdc9ff0
--- /dev/null
+++ b/docs/pessoal/conduta/anti-assedio.md
@@ -0,0 +1,12 @@
+# Anti-assédio e anti-discriminação
+
+## Prevenção e combate
+
+Cartilhas e manuais anti-assédio e anti-discriminação:
+
+* [Prevenção aos assédios moral e sexual - Capes](https://www.gov.br/capes/pt-br/centrais-de-conteudo/documentos/16102023_Cartilha_de_Preveno_aos_assdios_moral_e_sexual.pdf).
+* [Assédio moral no trabalho: perguntas e respostas - MPT](https://mpt.mp.br/pgt/publicacoes/cartilhas/assedio-moral-no-trabalho-perguntas-e-respostas/@@display-file/arquivo_pdf).
+* [Assédio moral e sexual - Previna-se - CNMP](https://www.mpf.mp.br/sc/arquivos/cartilha-assedio)
+ ([cópia](https://www.cnmp.mp.br/portal/publicacoes/245-cartilhas-e-manuais/9982-assedio-moral-e-sexual-previna-se)).
+* [Manual sobre a prevenção e o enfrentamento ao assédio moral e sexual e à discriminação](https://mpt.mp.br/pgt/publicacoes/manuais/manual-sobre-a-prevencao-e-o-enfrentamento-ao-assedio-moral-e-sexual-e-a-discriminacao/@@display-file/arquivo_pdf).
+* [Assédio Moral, Sexual e Discriminação Saiba mais sobre essas distorções de conduta no ambiente de trabalho](https://biblioteca.mpf.mp.br/server/api/core/bitstreams/a7da884c-fefb-4641-a301-a22abeb93824/content).
diff --git a/docs/pessoal/conduta/debates/README.md b/docs/pessoal/conduta/debates/README.md
deleted file mode 100644
index 982f21d..0000000
--- a/docs/pessoal/conduta/debates/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Conduta em Debates
-
-Existem vários modos de conduta em debates.
-Esta seção documenta alguns deles, disponibilizados para quem quiser usar.
diff --git a/docs/pessoal/conduta/modelos/README.md b/docs/pessoal/conduta/modelos/README.md
deleted file mode 100644
index a0763ad..0000000
--- a/docs/pessoal/conduta/modelos/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Modelos de Código de Conduta Pessoal
-
-Esta seção trata de códigos que podem ser adotados por padrão, em situações
-onde haja ausência de códigos explíticos.
diff --git a/docs/pessoal/conduta/debates/modelos/estrito.md b/docs/pessoal/conduta/modelos/debates/estrito.md
index 15e3a65..1837828 100644
--- a/docs/pessoal/conduta/debates/modelos/estrito.md
+++ b/docs/pessoal/conduta/modelos/debates/estrito.md
@@ -1,6 +1,6 @@
# Conduta Estrita em Debates
-Versão: 0.0.1 (2024-08-15).
+## Introdução
No modo de conduta estrita, o comportamento é otimizado para evitar
desconfortos.
@@ -18,7 +18,7 @@ desconfortos.
## Preparando sua fala
* Para não desperdiçar o tempo alheio, prepare de antemão a sua intervenção.
-* Prepare, se possível, materiais auxiliares (audivisuais, slides, panfletos etc).
+* Prepare, se possível, materiais auxiliares (audiovisuais, slides, panfletos etc).
## Fala inicial padrão
@@ -30,8 +30,9 @@ Este pode ser um exemplo de pontos para uma fala inicial padrão:
* Agradecimento pela atenção e oportunidade.
* Alerta sobre possíveis gatilhos, e do quanto (não-)prioritário é
o assunto.
- * Ainda estou aprendendo tudo isso, e gostaria de compartilhar o que
- aprendi e sobre o que ainda quero aprender.
+ * Afirmar que ainda está aprendendo tudo isso, e que gostaria de
+ compartilhar o que aprendeu até o momento e sobre o que ainda quer
+ aprender.
* Reconhecimento/enunciação dos meus privilégios, de quanto sou parte dos
problemas, e quanto acredito (ou posso ser) parte das soluções.
* Disclaimers opcionais:
@@ -65,3 +66,8 @@ Após contribuições/colocações/retornos de terceiros:
* Refletir sobre como foi sua participação, especialmente relativamente
às ponderações, sugestões etc recebidas.
+
+## Metadados
+
+* {{ metadata.version.pt }}: `0.0.2 (2024-08-15)`.
+* {{ metadata.identifier.pt }}: `pid:conduta:debate_estrito`.
diff --git a/docs/pessoal/conduta/modelos/quadrado.md b/docs/pessoal/conduta/modelos/quadrado.md
index 85e4528..ed2eea3 100644
--- a/docs/pessoal/conduta/modelos/quadrado.md
+++ b/docs/pessoal/conduta/modelos/quadrado.md
@@ -1,9 +1,9 @@
# Pisando no Quadrado: um Código de Conduta Padrão
-Versão: 0.0.2 (2024-08-15).
+Este é um checklist de procedimentos e código de conduta.
+Você tem uma ideia de como se portar em cada um desses items?
-Este é um checklist de procedimentos e código de conduta. Você tem uma ideia de
-como se portar em cada um desses items?
+## Checklist
* Comunicação implícita e explícita:
* O que pode ser assumido de antemão.
@@ -67,3 +67,8 @@ como se portar em cada um desses items?
* Uma maneira de abordar a ambiguidade dos alertas de gatilho talvez seja formulá-los
de modo que a pessoa possa ter a escolha de como e quando lidar com suas
questões, ao invés de ser pega de surpresa.
+
+## Metadados
+
+* {{ metadata.version.pt }}: `0.0.3 (2024-08-15)`.
+* {{ metadata.identifier.pt }}: `pid:conduta:quadrada`.
diff --git a/docs/todo.md b/docs/todo.md
index b5c10c8..de46d5d 100644
--- a/docs/todo.md
+++ b/docs/todo.md
@@ -14,13 +14,13 @@ Lista de tarefas deste projeto.
* @nahema2017 sobre "protocolos atrofiados".
* @nahema2024 pág. 107 sobre sistemas sócio-técnicos (Grupo de Tavistock).
* [ ] Re-estruturação inspirada em projetos como o Copy Far "AI":
- * Usar plugins de metainformação (`macros`).
- * Re-estruturar pastas.
- * Cada tema/tópico numa pasta, com um texto introdutório independente de
- protocolo específico.
- * Cada tema/tópico pode ter inúmeros protocolos.
- * Nome, ID e versão para cada protocolo.
- * Versão de cada documento original.
+ * [x] Usar plugins de metainformação (`macros`).
+ * [x] Nome, ID e versão para cada protocolo.
+ * [x] Versão de cada documento original.
+ * [ ] Re-estruturar pastas.
+ * [ ] Cada tema/tópico numa pasta, com um texto introdutório independente de
+ protocolo específico.
+ * [ ] Cada tema/tópico pode ter inúmeros protocolos.
## Template
@@ -47,35 +47,36 @@ Um esboço deste tipo foi feito no [RSP](https://rsp.fluxo.info).
e transferências), que funcione para todos os projetos. Campos: data,
credor, valor, ID da transação etc.
-## Ética
+## Conduta
-* [ ] Incluir nos códigos de conduta:
+* [ ] Introdução:
* Erich Fromm: amor socialista, 2R 2C: base para qualquer relação.
- * Política Anti-Assédio:
- * Sobre assediadores saberem como e quem assediar. O assédio não
- ocorre somente contra uma pessoa, como é parte de toda uma rede
- de relações sociais onde assediadores estabelecem níveis de
- relação, compartimentalização, divisionismo etc de modo que
- seja estabelecida um modus operandi de perpetuação e
- acobertamento.
- * Conduta estrita:
- * Se te consideram, ou se você se considera, uma pessoa de privilégios.
- * Avisar as pessoas quando você não estiver em condições de convívio,
- para que não pensem que o problema é com elas.
- * Não encostar nas pessoas.
- * Não encarar ninguém.
- * Relações poluídas, pré-carregadas de traumas e más experiências
- anteriores. Cada pessoa pode trazer bagagens boas e ruins numa
- relação. E as relações tendem a já começar dentro de uma sociedade
- poluída com violências.
- * Primeiro encontro, tensão, assumir as piores possibilidades, precaução.
- Voto de boas intenções, compreensão das tensões pré-existentes e
- voto de confiança para que eventuais encontros posteriores sejam
- melhores; encontros subsequentes confiança.
- * Reconhecer o quanto sua mera existência ou presença já pode ser uma
- violência para outros seres. Tentar ao máximo reduzir essa violência.
- * Estimar se a sua presença e atitudes serão mais benéficas do que os
- prejuízos que ela pode trazer a outros seres e ao ambiente.
+* [ ] Linguagens inclusivas, de gênero neutro, não-binárias etc.
+* [ ] Política Anti-Assédio:
+ * Sobre assediadores saberem como e quem assediar. O assédio não
+ ocorre somente contra uma pessoa, como é parte de toda uma rede
+ de relações sociais onde assediadores estabelecem níveis de
+ relação, compartimentalização, divisionismo etc de modo que
+ seja estabelecida um modus operandi de perpetuação e
+ acobertamento.
+* [ ] Conduta estrita:
+ * Se te consideram, ou se você se considera, uma pessoa de privilégios.
+ * Avisar as pessoas quando você não estiver em condições de convívio,
+ para que não pensem que o problema é com elas.
+ * Não encostar nas pessoas.
+ * Não encarar ninguém.
+ * Relações poluídas, pré-carregadas de traumas e más experiências
+ anteriores. Cada pessoa pode trazer bagagens boas e ruins numa
+ relação. E as relações tendem a já começar dentro de uma sociedade
+ poluída com violências.
+ * Primeiro encontro, tensão, assumir as piores possibilidades, precaução.
+ Voto de boas intenções, compreensão das tensões pré-existentes e
+ voto de confiança para que eventuais encontros posteriores sejam
+ melhores; encontros subsequentes confiança.
+ * Reconhecer o quanto sua mera existência ou presença já pode ser uma
+ violência para outros seres. Tentar ao máximo reduzir essa violência.
+ * Estimar se a sua presença e atitudes serão mais benéficas do que os
+ prejuízos que ela pode trazer a outros seres e ao ambiente.
## Expedições
diff --git a/docs/usando.md b/docs/usando.md
index 2a5d110..26bfe51 100644
--- a/docs/usando.md
+++ b/docs/usando.md
@@ -1,5 +1,7 @@
# Como usar este projeto
+## Introdução
+
A modularidade de tais protocolos permite que eles sejam adotados tanto como um
todo quanto em pequenos conjuntos (ou mesmo unitariamente) sem perda de
consistência desde que seja observada a dependência entre protocolos/processos.
@@ -12,4 +14,12 @@ de texto `$coletivo` podem ser substituídas pelo nome do seu grupo.
## Clonando o código
- git clone https://git.fluxo.info/templates
+O código pode ser obtido diretamente de um dos seus espelhos:
+
+* Espelho #1: [https://git.fluxo.info/templates](https://git.fluxo.info/templates).
+* Espelho #2: [https://0xacab.org/rhatto/protocolos.git](https://0xacab.org/rhatto/protocolos.git).
+
+## Metadados
+
+* {{ metadata.version.pt }}: `ver:2024-09-14`.
+* {{ metadata.identifier.pt }}: `pid:usando`.
diff --git a/mkdocs.yml b/mkdocs.yml
index 0f00786..2df8a87 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -75,6 +75,7 @@ plugins:
- locale: en
name: English
build: true
+
- locale: pt
name: Português
build: true
@@ -82,6 +83,10 @@ plugins:
nav_translations:
Provedor: Provider
+ # MkDocs-Macros Plugin
+ # https://mkdocs-macros-plugin.readthedocs.io
+ macros: {}
+
# Redirects
# https://github.com/mkdocs/mkdocs-redirects
# In case site re-structure is needed, this plugin will ensure permalink functionality
@@ -117,3 +122,32 @@ copyright: Copyleft &copy; 2024
# https://www.mkdocs.org/user-guide/configuration/#extra
extra:
generator: false
+
+ metadata:
+ version:
+ pt: >
+ Versão deste documento
+
+ en: >
+ Document version
+
+ identifier:
+ pt: >
+ Identificador
+
+ en: >
+ Identifier
+
+ original_identifier:
+ pt: >
+ Documento original
+
+ en: >
+ Original document
+
+ original_version:
+ pt: >
+ Traduzido e adaptado da versão original em Português
+
+ en: >
+ Translated and adapted from the original Portuguese version
diff --git a/scripts/provision b/scripts/provision
index a22e424..a47f524 100755
--- a/scripts/provision
+++ b/scripts/provision
@@ -13,7 +13,7 @@ DEPENDENCIES="mkdocs apache2 python3-pip pandoc"
DEPENDENCIES="$DEPENDENCIES tor python3-requests python3-bs4 python3-socks python3-pybtex"
# PyPI dependencies
-DEPENDENCIES_PIP="mkdocs-bibtex mkdocs-material mkdocs-awesome-pages-plugin mkdocs-static-i18n mkdocs-redirects"
+DEPENDENCIES_PIP="mkdocs-bibtex mkdocs-material mkdocs-awesome-pages-plugin mkdocs-static-i18n mkdocs-redirects mkdocs-macros-plugin"
# Ensure an up-to-date system
sudo apt-get update && sudo apt-get dist-upgrade -y && sudo apt-get autoremove -y && sudo apt-get clean