diff --git a/README.md b/README.md index 9c01b38..5c39991 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Open Models - Brick of Knowledge -**\[Brick under construction, see [roadmap](organisation/feuille-de-route.md)\]** +**\[Brick under construction, see [roadmap](organisation/roadmap.md)\]** Digital is a new world that we have only just begun to explore. @@ -22,21 +22,21 @@ A resource to acquire basic skills in open models and being an active player in **Open models knowledge :** -* [Introduction to open models](contenu/introduction.md) -* [History of open models](contenu/histoire.md) -* [Method for building a digital commons](contenu/methode/README.md) -* [List of open models](contenu/mod%C3%A8les/README.md) -* [List of projects](contenu/projets/README.md) +* [Introduction to open models](content/introduction.md) +* [History of open models](content/history.md) +* [Method for building a digital commons](content/method/README.md) +* [List of open models](content/models/README.md) +* [List of projects](content/projects/README.md) -A [list of resources](ressources.md) on open models brings together a variety of useful links. +A [list of resources](resources.md) on open models brings together a variety of useful links. ## Workshop materials 📚 -Open model education takes many forms and reaches many audiences, a multitude of teaching materials can be created and reused. To help you set up activities, a whole range of open resources can be found on a page dedicated to [materials for open models education workshops](materiel-atelier.md). +Open model education takes many forms and reaches many audiences, a multitude of teaching materials can be created and reused. To help you set up activities, a whole range of open resources can be found on a page dedicated to [materials for open models education workshops](workshop-material.md). ## Roadmap đŸ—ș -To set and understand the orientation of the community around the brick, a [roadmap](organisation/feuille-de-route.md) shows the main axes of work defined. +To set and understand the orientation of the community around the brick, a [roadmap](organisation/roadmap.md) shows the main axes of work defined. A collective project, a collaboratively built digital commons, open to contribution and hosted (temporarily đŸ€ž) on the non-open-source [GitHub](https://github.com/Open-Models/Brique) platform. @@ -44,7 +44,7 @@ A collective project, a collaboratively built digital commons, open to contribut The digital commons are based on an entire culture of contribution. The contributions of each individual contribute to the prosperity of the whole, provided that the ecosystem around a project is able to include external players. -A [contribution guide](organisation/guide-contribution.md) explains different ways to help on this brick of knowledge project. +A [contribution guide](organisation/contribution-guidelines.md) explains different ways to help on this brick of knowledge project. Many ways to participate in this democratization of open models! diff --git a/content/method/README.md b/content/method/README.md index 28a8cbf..c86491e 100644 --- a/content/method/README.md +++ b/content/method/README.md @@ -10,9 +10,9 @@ Open models are often (but not exclusively) based on the establishment of a digi There is a whole range of strategies for structuring a digital commons, we are now searching for a certain methodology. -* **Rule n°1**: [Make a project that makes sense and is based on a common purpose](regle-1.md) -* **Rule n°2**: [Work and communicate publicly](regle-2.md) -* **Rule n°3**: [Competition doesn't exist, turn everyone into a partner](regle-3.md) -* **Rule n°4**: [Being able to integrate external contributors](regle-4.md) -* **Rule n°5**: [Improving a resource through peer review](regle-5.md) -* **Rule n°6**: [Architect a digital work environment](regle-6.md) +* **Rule n°1**: [Make a project that makes sense and is based on a common purpose](rule-1.md) +* **Rule n°2**: [Work and communicate publicly](rule-2.md) +* **Rule n°3**: [Competition doesn't exist, turn everyone into a partner](rule-3.md) +* **Rule n°4**: [Being able to integrate external contributors](rule-4.md) +* **Rule n°5**: [Improving a resource through peer review](rule-5.md) +* **Rule n°6**: [Architect a digital work environment](rule-6.md) diff --git a/content/method/rule-4.md b/content/method/rule-4.md index 201abaa..ee279cd 100644 --- a/content/method/rule-4.md +++ b/content/method/rule-4.md @@ -4,7 +4,7 @@ Welcoming external contributions requires careful thought and the implementation The aim is to reduce this needed energy as much as possible. Various elements will reduce this friction, such as the availability of information, the way decisions are made, the complexity of the resource, the digital environment and so on. -The basic practice in the software world is to provide a "contribution guide", the documentation will be a tool to enable this integration. For example, the Python language offers a guide to contributing: https://devguide.python.org/. They explain how to retrieve code, submit modifications, link to various tools such as bug tracker, resources for getting started with CPython (Python's C code)... A contribution guide can also be found on Wikipedia (https://fr.wikipedia.org/wiki/Aide:D%C3%A9buter), or under construction for the open models knowledge brick (https://github.com/Open-Models/Brique/blob/main/guide-contribution.md). +The basic practice in the software world is to provide a "contribution guide", the documentation will be a tool to enable this integration. For example, the Python language offers a guide to contributing: https://devguide.python.org/. They explain how to retrieve code, submit modifications, link to various tools such as bug tracker, resources for getting started with CPython (Python's C code)... A contribution guide can also be found on Wikipedia (https://fr.wikipedia.org/wiki/Aide:D%C3%A9buter), or under construction for the open models knowledge brick (https://github.com/Open-Models/Brique/blob/main/organisation/contribution-guideline.md). The quality of the code, its structuring and, more generally, the complexity of a resource will influence how easy it is to contribute. If nobody understands it, in a « spaghetti code » for example, this will make participation very difficult. diff --git a/content/models/README.md b/content/models/README.md index c5594b7..9be42a2 100644 --- a/content/models/README.md +++ b/content/models/README.md @@ -1,7 +1,5 @@ ## List of open templates -**\[Page under construction, see [#2](https://github.com/Open-Models/Brique/issues/2)\]** - * [Open Education](open-education.md) * [Open Science](open-science.md) * [Open Collaboration](open-collaboration.md) diff --git a/content/models/open-education.md b/content/models/open-education.md index b035275..f57fda1 100644 --- a/content/models/open-education.md +++ b/content/models/open-education.md @@ -41,7 +41,7 @@ Although limited and highly variable from one field to another, it is already po On certain new subjects or those that are insufficiently taught in traditional education, it even seems necessary to rely on open education for training, starting with open models or ecology. -Impossible to meet all needs and cite all existing open educational resources, it will be important to conduct an exploration phase on the Internet or in OER databases, [the list of resources in the brick](/ressources.html) is a first track. +Impossible to meet all needs and cite all existing open educational resources, it will be important to conduct an exploration phase on the Internet or in OER databases, [the list of resources in the brick](/resources.html) is a first track. There is no single answer to the problem of how to produce open education training. There is a whole range of possible approaches, from publishing a PowerPoint-type presentation under an open license, to structuring a complex environment for collaboratively producing OER and enabling interaction between learners. @@ -49,7 +49,7 @@ While we know that much remains to be invented, the tools needed to produce open > **The Open Models Knowledge Brick** is a complex example of open education, an experiment of open educational resource for education in open models, in a digital commons logic developed using open software tools such as [Markdown](https://www.markdowntutorial.com/), [git](https://about.gitlab.com/topics/version-control/what-is-git-version-control/) and [GitHub](https://fr.wikipedia.org/wiki/GitHub). > -> The project is intended to be a resource accessible to anyone wishing to learn about open models. Although it requires some technical knowledge with which to familiarize oneself, all content is retrievable, modifiable and shareable. Pedagogical content that is freely accessible, that can be co-produced, based on [spaces for exchange with the community around the project](/README.html#contribuer-), learners and stakeholders who gravitate around open models +> The project is intended to be a resource accessible to anyone wishing to learn about open models. Although it requires some technical knowledge with which to familiarize oneself, all content is retrievable, modifiable and shareable. Pedagogical content that is freely accessible, that can be co-produced, based on [spaces for exchange with the community around the project](/README.html#contribute-), learners and stakeholders who gravitate around open models > > Many trainers in open models and in digital technology more broadly could find interest in this type of pedagogical content within a whole range of organizations: schools, universities, but also in IT, public institutions, etc. The commercial use of the brick being permitted, a service activity such as offering training in open models on a freelance basis becomes possible. diff --git a/organisation/roadmap.md b/organisation/roadmap.md index 2a6dda6..97dabc2 100644 --- a/organisation/roadmap.md +++ b/organisation/roadmap.md @@ -4,7 +4,7 @@ Open models are subjects that evolve over a long period of time, from decades to The objectives around the brick of knowledge on open models are going to be to disseminate these models through educational work to acculturate the citizen of the XXIᔉ century, continue to build this digital common and federate an ecosystem of stakeholders around these dynamics to prepare for the future. -In an open logic, everyone is free to contribute according to their skills, desires and financial/time/geographical/etc. constraints. More details in the [contribution guide](guide-contribution.md). +In an open logic, everyone is free to contribute according to their skills, desires and financial/time/geographical/etc. constraints. More details in the [contribution guidelines](contribution-guidelines.md).