Nossa Comunidade: Mentes e Corações que Moldam o Futuro

A Tecnologia Takwara não é apenas um conjunto de técnicas; é um movimento impulsionado por uma comunidade vibrante de pensadores, criadores, pesquisadores e apoiadores que abriram portas e corações. Acreditamos que o conhecimento mais poderoso é aquele que é compartilhado, evoluído e construído coletivamente. Cada contribuição, seja um novo artigo, um teste de campo, uma linha de código, uma ideia inovadora ou um apoio financeiro, é um tijolo fundamental na construção de um futuro mais sustentável e justo.

💡 Idealizadores e Curadores de Conteúdo

• Fabio "Takwara" Resck

  • Visão e Liderança: Idealizador do projeto, pesquisador autônomo, militante socioambiental. Autor da Tecnologia Takwara.
  • Contribuição: Curadoria e desenvolvimento de todo o conhecimento técnico, arquitetura da plataforma, mentoria e inspiração para a comunidade.
  • Contato: fabiotakwara@gmail.com
  • Visual: [Foto de Fabio Takwara]

• Seu Nome

  • Sua Expertise: Descreva de forma clara.
  • Contribuição: Edição, revisão, curadoria, articulista, redator, fotógrafo, projetista .
  • Contato: seuemail@gmail.com
  • Visual: [Foto se desejar]

---

Apoio à Nossa Missão: Contribuições Financeiras e de Recursos

Acreditamos no poder do conhecimento livre e aberto. No entanto, para sustentar a infraestrutura tecnológica (APIs, armazenamento), o tempo dedicado à curadoria, edição, desenvolvimento e o contínuo aprimoramento da plataforma, necessitamos de um modelo que reconheça o investimento e o esforço humano e de recursos. Além disso, o desenvolvimento de testes e protótipos demandam a mobilização de pessoas, acomodação, transporte, alimentação. A filosofia Takwara sempre foi de pesquisa compartilhada e a contribuição voluntária, ajude a manter este princípio, permitindo a realização de cursos e vivências acessíveis.

Por que sua Contribuição é Essencial:

• Custo de Infraestrutura: Manter as APIs de Inteligência Artificial (Google Cloud) e o armazenamento da base de dados vetorial (ChromaDB) geram custos operacionais.
• Tempo e Dedicação: A curadoria rigorosa, a edição de textos com tom militante, a organização do conteúdo, o desenvolvimento de scripts e a manutenção da plataforma exigem um investimento significativo de tempo e esforço humano.
• Desenvolvimento Contínuo: Garantir que a Tecnologia Takwara continue evoluindo, que novas pesquisas sejam integradas e que a AVT se torne cada vez mais inteligente e útil.
• Impacto Social: Sua contribuição ajuda a democratizar o acesso a soluções sustentáveis, empoderando comunidades e impulsionando a ação socioambiental.

Como Você Pode Apoiar a Tecnologia Takwara:

• Doações Financeiras:

  • Plataformas: [/Users/fabiotakwara/Documents/GitHub/Takwara-Tech/Chatbot - Takwara/docs/assets/images/pix.png, /Users/fabiotakwara/Documents/GitHub/Takwara-Tech/Chatbot - Takwara/docs/assets/images/qrcode.png]

  • Reconhecimento: Todas as doações serão reconhecidas publicamente (com permissão do doador) nesta seção.

  • Recursos e Parcerias:
  • Você é uma empresa, instituição ou projeto com recursos que possam ser compartilhados (ex: acesso a APIs, licenças de software, infraestrutura de cloud, equipamentos)? Entre em contato para discutir parcerias estratégicas.
  • Tempo e Expertise (Colaboração):
  • Se você tem tempo e expertise para contribuir como pesquisador,desenvolvedor, editor, fotógrafo, designer, revisor ou tradutor, por favor, consulte nossa seção "Como Contribuir".

---

Manual de Edição e Solicitação de Publicação para Colaboradores:

Para garantir a qualidade e a consistência do conteúdo, especialmente quando produzido por múltiplos colaboradores, precisamos de um guia simples:

1. Entendendo o Nosso Estilo e Propósito:

• Tom: Militante, engajado, com urgência climática, mas sempre baseado em dados e evidências científicas. Linguagem clara, objetiva e inspiradora.
• Foco: Construção sustentável com bambu, impacto socioambiental, soluções para as crises climáticas e habitacionais.
• Objetivo: Educar, engajar e mobilizar para ação.

2. Formatação do Conteúdo (Markdown):

• Hierarquia: Use corretamente os títulos (# para título principal, ## para seções, ### para subseções). Cada arquivo .md deve ter um título principal (#).
• Parágrafos: Mantenha parágrafos concisos e bem estruturados.
• Listas: Use listas com marcadores (- ou *) ou numeradas (1.) para clareza.
• Ênfase: Use negrito para destacar termos importantes e itálico para ênfase sutil.
• Links:
  • Links Internos: Sempre que mencionar um conceito ou tecnologia que tem um documento dedicado neste repositório, crie um link para ele usando a sintaxe Markdown: [Texto do Link](caminho/para/o/documento.md). Use caminhos relativos (ex: ../tecnologias/forno-ecologico.md).
  • Links Externos: Use links para fontes confiáveis (artigos científicos, relatórios de ONGs renomadas, sites oficiais, dados governamentais). Formato: [Texto do Link](URL_externa).
• Imagens:
  • Coloque as imagens na pasta docs/assets/images/.
  • Use a sintaxe Markdown: ![Texto Alternativo da Imagem](assets/images/nome-da-imagem.jpg). O texto alternativo é importante para acessibilidade.
  • Use nomes de arquivo descritivos para imagens.
• Citações e Fontes:
  • Para citações diretas ou para dar crédito a fontes externas, use aspas e um link para a fonte.
  • Para referências bibliográficas, crie uma seção de bibliografia no final do seu artigo ou em um arquivo dedicado docs/referencias.md, linkando para ela.
• Prefixo para Ordenação: Ao salvar um novo arquivo ou pasta, adicione o prefixo alfanumérico no início do nome do arquivo para definir sua posição no menu. Ex: A3.1. O Futuro do Bambu.md.

3. Solicitação de Publicação (Via GitHub Issues/Pull Requests):

• Para Contribuidores Externos ou Novos Colaboradores:
  1. Faça um Fork do Repositório: Crie uma cópia do repositório para sua conta GitHub.
  2. Clone o Seu Fork: Baixe essa cópia para o seu computador.
  3. Crie um Novo Branch: git checkout -b sua-contrib-nome-funcionalidade
  4. Faça Suas Edições: Escreva seu artigo, adicione imagens, crie o novo arquivo, organize pastas, etc., seguindo as diretrizes de edição.
  5. Use o Script de Navegação (se necessário): Se você adicionou ou renomeou arquivos/pastas, vá para a raiz do repositório, execute python Chatbot - Takwara/generate_mkdocs_nav.py e salve as mudanças no mkdocs.yml.
  6. Valide Localmente (Opcional, mas Recomendado): Na raiz do repositório, rode mkdocs serve e confira se tudo está como esperado no navegador local.
  7. Commit e Push:

     git add .
     git commit -m "feat: Adiciona artigo sobre X por [Nome do Colaborador]" # Mensagem clara e informativa
     git push origin sua-contrib-nome-funcionalidade
     

  8. Crie um Pull Request (PR): Vá até o seu fork no GitHub, clique em "Pull requests" e crie um novo PR, apontando do seu branch (sua-contrib-nome-funcionalidade) para o branch main do repositório original (Resck/Takwara-Tech).
  9. Descreva Sua Contribuição: No campo de descrição do PR, explique claramente o que você adicionou/modificou, sua relevância para o projeto e, se aplicável, como você gostaria de ser reconhecido na seção de colaboradores. Mencione as APIs utilizadas ou custos incorridos, se for o caso (como contribuição financeira).