Update Contributing.md

Contributing.md

@@ -1,96 +1,126 @@
+Thank you for your interest in contributing to **MarCognity-AI**, the open-source framework dedicated to experimentation in reflective artificial intelligence.
+
+Every contribution is welcome: code, documentation, tests, ideas, and issue reports.  
+MarCognity-AI is not just a technical project — it's a shared vision.
 
-Grazie per il tuo interesse nel contribuire a MarCognity-AI , il framework open source dedicato alla sperimentazione dell'intelligenza artificiale riflessiva.
-
-Ogni contributo è benvenuto: codice, documentazione, test, idee e segnalazioni di problemi.
-MarCognity-AI non è solo un progetto tecnico: è una visione condivisa.
-
-##Prima di iniziare
-
-Assicurati che il tuo contributo sia in linea con la visione etica e scientifica del progetto .
-Leggere i file README.mde LICENSEper comprendere obiettivi e vincoli.
-Mantenere un tono rispettoso e costruttivo in tutte le interazioni.
-Tipi di contributi accettati
-Correzioni di bug
-Ottimizzazione del codice
-Nuove funzionalità modulari (LLM, incorporamenti, metacognizione, ecc.)
-Traduzioni in altre lingue
-Segnalazioni di problemi (idee, anomalie, suggerimenti di refactoring)
-Contributi in formato Jupyter Notebook ( .ipynb)
-I quaderni sono essenziali per presentare esempi, test cognitivi e soluzioni.
-Puoi contribuire:
 ---
-Quaderni dimostrativi
-Tutorial interattivi
-Test per moduli cognitivi
-Per favore:
-
-Inizia con una cella Markdown che include titolo, scopo, autore e licenza
-Mantenere il quaderno pulito e ben documentato
-Salva il file nella notebooks/cartella
-Requisiti tecnici
-
-Per i moduli Python ( .py)
-
-Seguire le convenzioni di denominazione e di stile
-Includi docstring e commenti chiari
-Evitare dipendenze inutili
-Garantire la compatibilità con i modelli e le licenze esistenti
-Posizionare i file nella struttura corretta src/o marcognity/con la struttura corretta
+
+## Before You Begin
+
+- Ensure your contribution aligns with the project's **ethical and scientific vision**.
+- Read the `README.md` and `LICENSE` files to understand goals and constraints.
+- Maintain a respectful and constructive tone in all interactions.
+
 ---
-Per Jupyter Notebook ( .ipynb)
-
-Inizia con una cella Markdown: titolo, scopo, autore, licenza
-Mantenere il quaderno pulito e ben documentato
-Utilizzare i moduli del progetto per dimostrare la funzionalità
-Salva nella notebooks/cartella
-Cose da evitare
-Modifiche che consentono l'uso commerciale diretto (non consentite dal progetto)
-Modelli closed-source o non verificabili
-Contenuti o funzionalità che violano i principi etici
-Richieste di pull incomplete o inspiegabili
-Test e qualità del codice
-Prima di inviare un contributo, testalo attentamente per garantirne stabilità e compatibilità.
+
+## Accepted Contribution Types
+
+- Bug fixes  
+- Code optimization  
+- New modular features (LLMs, embeddings, metacognition, etc.)  
+- Translations into other languages  
+- Issue reports (ideas, anomalies, refactoring suggestions)
+
 ---
-Comunicazione
-Per proporre idee o discutere nuove funzionalità:
-
-Apri un problema
-Utilizzare la sezione Discussioni del repository
-Oppure commenta direttamente sotto la tua richiesta di pull
-Note aggiuntive e uso previsto
-MarCognity-AI è distribuito con licenza Apache 2.0 .
-Puoi utilizzarlo, modificarlo e condividerlo liberamente per progetti di ricerca, istruzione e open source , a condizione che venga preservata l'attribuzione originale.
+
+## Contributions in Jupyter Notebook Format (`.ipynb`)
+
+Notebooks are essential for showcasing examples, cognitive tests, and walkthroughs.  
+You can contribute:
+
+- Demonstration notebooks  
+- Interactive tutorials  
+- Tests for cognitive modules
+
+Please:
+
+- Start with a Markdown cell including title, purpose, author, and license  
+- Keep the notebook clean and well-documented  
+- Save the file in the `notebooks/` folder
+
+---
+
+## Technical Requirements
+
+### For Python Modules (`.py`)
+- Follow naming and style conventions  
+- Include clear docstrings and comments  
+- Avoid unnecessary dependencies  
+- Ensure compatibility with existing models and licenses  
+- Place files in `src/` or `marcognity/` with proper structure
+
+### For Jupyter Notebooks (`.ipynb`)
+- Begin with a Markdown cell: title, purpose, author, license  
+- Keep the notebook clean and well-documented  
+- Use project modules to demonstrate functionality  
+- Save in the `notebooks/` folder
+
 ---
-Diritti concessi da Apache 2.0:
-Utilizzare, modificare e distribuire il codice
-Uso commerciale del codice (con eccezioni per modelli specifici)
-Possibilità di biforcare e creare versioni derivate
-Questo progetto include prompt originali e codice Python sviluppato da Elena Marziali.
-Tutti i contenuti sono rilasciati con licenza Apache 2.0.
-È vietata la rimozione del copyright o la ridistribuzione senza attribuzione.
+
+## Things to Avoid
+
+- Changes that enable direct commercial use (not permitted by the project)  
+- Closed-source or unverifiable models  
+- Content or features that violate ethical principles  
+- Incomplete or unexplained Pull Requests
+
 ---
-Ringraziamenti
-Ogni contributo accettato sarà menzionato nel changelog e, se significativo, nella sezione autori.
-Crediamo nella collaborazione trasparente e nel riconoscimento basato sul merito.
 
-## 🔗 Codice sorgente completo
+## Testing and Code Quality
 
-Il codice Python del framework, con la cartella `src/`, è disponibile su GitHub.
+Before submitting a contribution, please test it thoroughly to ensure stability and compatibility.
 
-Per esplorare la logica interna, i moduli cognitivi e le funzioni personalizzate, consulta direttamente il repository.
+---
+
+## Communication
+
+To propose ideas or discuss new features:
+
+- Open an **Issue**  
+- Use the **Discussions** section of the repository  
+- Or comment directly under your Pull Request
+
+---
+
+## Additional Notes and Intended Use
+
+MarCognity-AI is distributed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0).  
+You are free to use, modify, and share it for **research, education, and open-source projects**, provided the original attribution is preserved.
+
+### Rights Granted by Apache 2.0:
+- Use, modify, and distribute the code  
+- Commercial use of the code **(with exceptions for specific models)**  
+- Ability to fork and create derivative versions
+
+This project includes original prompts and Python code developed by Elena Marziali.  
+All content is released under the Apache 2.0 license.  
+Removing copyright or redistributing without attribution is prohibited.
+
+---
+
+## Acknowledgments
+
+Every accepted contribution will be recognized in the changelog and, if significant, in the authors section.  
+We believe in transparent collaboration and merit-based recognition.
+
+If you reuse or modify this project, please cite the original author:
+
+> Based on MarCognity-AI created by [Elena Marziali or elenamarziali]  
+> Distributed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0)  
+> Includes models subject to specific licenses (e.g., LLaMA 4 – Meta Community License)
+
+You may include this citation in your paper, article, or presentation.  
+Every reference is appreciated and helps increase the project's visibility.
+
+> Marziali, E. (2025). *MarCognity-AI: Cognitive Framework for LLMs*. GitHub Repository. https://github.com/elenamarziali/MarCognity-AI.git
+
+---
 
-Se riutilizzi o modifichi questo progetto, ti preghiamo di citare l'autore originale:
+## Support and Contact
 
-Basato su MarCognity-AI creato da [Elena Marziali o elenamarziali]
-Distribuito sotto licenza Apache 2.0
-Include modelli soggetti a licenze specifiche (ad esempio, LLaMA 4 – Meta Community License)
+Have questions, concerns, or want to propose a broader collaboration?  
+Open an Issue or write in the Discussions section.  
+Every voice is heard.
 
-Puoi includere questa citazione nel tuo articolo, documento o presentazione.
-Ogni riferimento è apprezzato e contribuisce ad aumentare la visibilità del progetto.
 
-Marziali, E. (2025). MarCognity-AI: quadro cognitivo per LLM . Repository GitHub. https://github.com/elenamarziali/MarCognity-AI.git
 
-Supporto e contatti
-Hai domande, dubbi o vuoi proporre una collaborazione più ampia?
-Apri un problema o scrivi nella sezione Discussioni.
-Ogni voce è ascoltata.