📖 Documentação amigável

[thomasgroch]

Afim de facilitar para todos da hacktoberfest. recém-chegados atuais e futuros proponho contribuições a documentação do projeto.

É muito comum comunidades erroneamente interpretarem 'comunidade acolhedora' com a simpatia das pessoas de tratamento inter pessoal. Para projetos de código-aberto acredito que a própria documentação deva ser acolhedora, não as pessoas.

Listo aqui algumas tarefas sugeridas

• [ ] Unificar e simplificar todo setup inicial.
• [ ] Dividir instruções por sistema.
• [ ] Separar informações por idiomas.
• [ ] ...

[thomasgroch]

Para que o comuREDE se torne algo real seria necessário fazer algumas mudanças fundamentais.

• Mentalidade 'para comunidade' 🤔 Gostaria de clarificar nosso entendimento nesse tópico, se é 'para comunidade' não podemos impor o uso exclusivo a periferias. Melhor tomarmos este título organicamente (pelas caracteristicas do sistema) do que nos auto-intitula.

• O nome 💬 Um carro poderia se chamar 'maquina mortal', 'transportador' ou 'motel ambulante' embora o nome esteja alinhado com a função cujo o dono delegou não é exatamente um bom nome para tratar o produto em si.

Se esperamos que qualquer pessoa, mesmo sem nos conhecer, seja capaz de {instalar, gerir, administrar, cobrar-ou-nao, montar seu próprio modelo de negócio} e ainda nomea-lo como bem entender então precisamos de um nome mais generico.

Ex: WordPress ->️ Blog do Ciclano Magento ->️ Loja do Beutrano Chromium ->️ Chrome

• Repositórios 💻 O projeto está atualmente com um aspecto {jam,academico,prático}, tudo está no mesmissimo repositório.

Novamente se esperamos que qualquer pessoa seja capaz de propor {melhorias, discuções} então precisamos definir a responsabilidades de cada sistema e conseguentemente de cada repo. Assim cada sistema pode ter seu próprio guia de como contribuir.

⚠️ Eu queria dizer que estou muito feliz com a iniciativa comuREDE. Não existe estímulo de contribuição, mas com certeza fez uma grande diferença no desenvolvimento da ideia. E vamos resolver o problema temporário de ter que descobrir um formato mais colaborativo para nos permitir continuar com o projeto.

Deixe as chamas começarem. 🔥

[erikfig]

Achei o projeto muito legal,

Gostaria de contribuir, tenho alguma experiência na área, vou estudar o projeto, mas pelo que vi até agora, seria interessante uma reestruturação do código, talvez usar um framework e validar padrões.

Minha sugestão seria usar com o Laravel, já que tem mais adeptos e será mais fácil econtrar suporte nas comunidades, em seguida migrar o projeto.

Algumas coisas como conexão ao banco de dados e o próprio banco (eu não achei nenhum sql) já são resolvidos, como variáveis de ambiente (para configuração de conexão) e migrations (em vez de sql, da um suporte maior a outros bancos e até facilita um futuro deploy automático).

Também podemos tentar achar um front-end, pra dar uma melhorada no layout, tenho certeza que muita gente vai querer contribuir...

[erikfig]

Postei na comunidade que perticipo no Telegram, lá tem bastante gente, se topar minha sugestão, cria um branch novo (talvez um chamado dev) que vamos tentar te ajudar, bom eu vou, pelo menos.

https://t.me/phpbrasil

[frimes]

Achei o projeto muito legal,

Gostaria de contribuir, tenho alguma experiência na área, vou estudar o projeto, mas pelo que vi até agora, seria interessante uma reestruturação do código, talvez usar um framework e validar padrões.

Minha sugestão seria usar com o Laravel, já que tem mais adeptos e será mais fácil econtrar suporte nas comunidades, em seguida migrar o projeto.

Algumas coisas como conexão ao banco de dados e o próprio banco (eu não achei nenhum sql) já são resolvidos, como variáveis de ambiente (para configuração de conexão) e migrations (em vez de sql, da um suporte maior a outros bancos e até facilita um futuro deploy automático).

Também podemos tentar achar um front-end, pra dar uma melhorada no layout, tenho certeza que muita gente vai querer contribuir...

Olá Erick, que bom que gostou, obrigado!

Aqui temos um BD com a leitura de dois sensores, um de água e outro de luz, ao longo do mês inteiro de setembro:

https://olha.ai/V2aP2

Tem também o Modelo Entidade Relacional aqui:

https://olha.ai/2fUSM

Vou pedir ajuda no nosso grupo sobre o branch dev que sugeriu, que achei as ideias MASSA, mas sou novato aqui rs

Chegou a ver nosso vídeo?

https://www.facebook.com/comuREDE/videos/897710280400227/

Se puder, posta lá no teu grupo, que acredito que fica mais claro nossa proposta e propósito.

Entra no nosso lá também:

https://t.me/comuREDE

;-)

[romulotunala]

@erikfig E @thomasgroch Estou ajudando o @frimes a organizar tudo e desenvolver esse código.

@thomasgroch sobre tornar o projeto mais atrativo para a comunidade, vamos pensar com calma sobre o nome (não tenho certeza se mudar é uma boa opção) e a estrutura. Estamos empenhado em organizar o código para que ele esteja disponível para que outras pessoal testem e vejam como funciona.

@erikfig Vou criar a branch "development" e penso em trabalhar com GitFlow. Acredito que tornará o fluxo de colaboração mais tranquilo. Estou me preparando para reprogramar o front (com HTML5, CSS3 e JS) do projeto, já temos o novo layout é só programar. Temos alguns amigos trabalhando no docker para subir o banco de dados e disponibilizar uma versão development.

Posso ter falado besteira aqui, mas estamos iniciando aqui e vamos tentar organizar tudo para que seja atrativo e de fácil colaboração.

[erikfig]

Que top @romulotunala, vou criar adicionar uma instalação limpa do Laravel e começar a migrar o projeto atual, assim já teremos algo mais maduro