Aide:Ontologie autoconstruction
De Wiki maraîcher
Cette page d'aide décrit le développement ontologique lié au Portail de l'autoconstruction, pour assurer sa cohérence avec la structure ontologique globale du Wiki maraîcher.
Info sur l'alignement ontologique avec le standard Open Know-how
Le standard de méta-données Open Know How (OKW) est utilisé comme base de modélisation des pages de modèles d'équipements et de leurs instructions de fabrication.
Les tableaux suivants exposent les propriétés descriptives du standard et comment les liens ont été établis entre le Wiki maraîcher et le standard.
Pour le moment, la déclaration publique des propriétés ne se fait qu'avec l'ontologie de l'autoconstruction. Éventuellement, la publication des fiches avec l'ontologie du standard OKH pourra être ajouté en créant une requête en format approprié (.json, .csv, autre) pour pouvoir être publiée à l'externe.
| Titre (en anglais) | Propriété (en français) | Intégré | Notes | Numéro | Fieldname | Purpose | Format requis | Rules |
|---|---|---|---|---|---|---|---|---|
| Title | Titre | À ajouter | Devrait-on ajouter par Pagename au #set ou bien un champ clair dans la page? | 4.6.1. | title | A title to identify the thing. | Text. | Required. |
| Description | Description du modèle de l'équipement | X | OK | 4.6.2. | description | Describes the thing. | Paragraph. | Required. |
| Intended use | Usages attendus du modèle d'équipement | X | OK | 4.6.3. | intended-use | Informs the maker for what purpose the designer intends the thing to be used. In particular, make reference to the context and type of users. | Paragraph. | Recommended. |
| Keywords | Mot-clé | X | OK | 4.6.4. | keywords | Provides a small number of terms that can be used to help identify. | Array of text. | At least one keyword is recommended. |
| Project Homepage | Page du projet | X | OK : set automatique avec mot magique Fullurl. | 4.6.5. | project-link | Where the thing or associated project has a web presence that is separate from the documentation (e.g. a marketing page), links to the web resource. | Absolute path. | At least one of the project-link or documentation-home fields is required. |
| Health and safety notice | Notes santé et sécurité du modèle d'équipement | X | OK | 4.6.6. | health-safety-notice | Highlight health and safety risks and/or necessary precautions that the maker should be aware of as part of the decision to make the thing. | Paragraph | Not an exhaustive list of all risks associated with the thing, but a summary of the most important risks and hazards associated with making, using, maintaining or disposing. Knowledge of such issues could influence the decision to make the thing. |
| Primary contact | Pilote de développement | X | OK | 4.6.7. | contact | Provides a point of contact for people who wish to discuss the thing. | Voir norme pour les specs | Where used, provide at least one email address or social media user handle. |
| Contributors | Contributeur de développement | X | OK | 4.6.8. | contributors | Credits the contributors to the know-how. May include people who designed, produced documentation, tested the documentation by making, reviewed and/or edited documentation, or made another contribution as deemed valued by the project or manifest-author. | List of contributors Voir norme pour les specs | Recommended. A name is required for each contributor listed. |
| Image | Image | À ajouter | Passer résultat par requête si photos taguées avec sémantique? | 4.6.9. | image | Provides a graphical representation of the thing. | Absolute or relative path to image file. | Recommended. |
| Thing version | Version | X | OK | 4.6.10. | version | Defines the version of the thing that is represented by this manifest. | Text. | |
| Stage of development | Statut de développement | X | OK | 4.6.11. | development-stage | Indicates the maturity of the design and documentation development. (Note: The Open Know-How Working Group intends to develop recommended values for this field to support commonality across manifest files. This is likely to be made by reference to a external standard.) | Text | |
| Has been made | Fabriqué | X | Ok. Set automatique si statut de développement=Fabriqué | 4.6.12. | made | Indicates whether the thing has been made and verifies that it is makeable. | Boolean – “true” or “false“ | |
| Has been made independently | A été fabriqué indépendamment | À ajouter | Comment attribue-t-on cette propriété? Est-ce qu'on donne un statut Fabriqué indépendamment en 4.11 qu'on active quand on sait que qqun a réalisé l'équipement sans avoir participé à une corvée d'autoconstruction de la CAPÉ? | 4.6.13. | made-independently | Indicates whether the thing has been made using the documentation by someone who was not a contributor to the design or documentation and, therefore, verifies that the documentation is sufficient to make the thing. | Boolean – “true” or “false“ | |
| Standards used | Standards utilisés | ? | Est-ce pertinent et important? Publie-t-on des plans signés par un·e ingénieur·e? | 4.6.14. | standards-used | Indicates any standards that have been used in developing the design or documentation. | Array of arrays. Voir norme pour les specs | Do not list standards to be used by the maker or user, instead these should be referenced in the relevant documentation. |
| Derivative of | Dérivé de | À ajouter | 4.6.15. | derivative-of | Where the thing is a derivative of a different thing (e.g. the documentation has been forked), links to the original thing. | Voir norme pour les specs | Where derivative-of used, the title sub-field is required. | |
| Variant of | Variante de | À ajouter | 4.6.16. | variant-of | Where the thing is a variant, links to the original. | Voir norme pour les specs | ||
| Sub-thing | Composante | À ajouter | 4.6.17. | sub | Where the design uses sub-components, sub-assemblies etc that are also available as open know-how, links to the documentation. | List of sub-things Voir norme pour les specs | ||
| License | Licence | X | Ok. Licence matériel + Licence documentation + Licence logiciel. | 4.6.18. | License | States the licenses under which the thing is made available. | Voir norme pour les specs | Rules: At least one license is required. All three license types are recommended. The format should be an SPDX identifier [3]. See https://spdx.org/licenses/ |
| Licensor | Licenceur | ? | En évaluation : à ajouter? Comment nommer et comment opérer? | 4.6.19. | licensor | States who is licensing the thing. | Voir norme pour les specs |
