(Re-)Construire une base de connaissance style Wiki pour la v5 #142
Labels
No Label
Core
bug
duplicate
easy
enhancement
help wanted
invalid
performance
proposal
question
security
warning
wontfix
No Milestone
No Assignees
4 Participants
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: devs/PCv5#142
Loading…
Reference in New Issue
No description provided.
Delete Branch "%!s(<nil>)"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Construire une base de connaissance sur les calculatrices Casio.
Fusion des data existantes et splittées sur divers endroits :
1ere étape : lister l'existant et proposer une structure
idée importante : bien séparer le contenu de la mise en forme
Deux aspects importants de mon côté :
Question con (?), est-ce qu'on prévoit dès le départ un système de droit de lecture ? Je pense à tout ce qui est pas dans la Bible pour des questions de mode examen et tout.
Pour moi y'a pas besoin, mais j'aimerais votre avis sur la question.
À mon sens la base de connaissances visée est par nature publique donc s'il y a des données sensibles elles ne doivent pas y apparaître du tout.
Par contre un droit de modification me paraît utile. Il ne faudrait pas que n'importe quel compte puisse modifier sans contrôle
Autre question con : contenu en français, en anglais ou les deux ?
Réaction immédiate et appropriée de Darks sur la shout :
On a d'abord lancé la v5 en mode français uniquement, vue l'absence complète de public sur la version anglaise de Planète Casio v4. Mais je dois reconnaître que notre audience a un peu tourné et on a fréquemment des contributeurs anglophones. Je pense qu'on ne peut pas les négliger complètement.
À mon sens, il faut supporter les deux, mais dans un premier temps on recense/retranscrit/met à jour dans la langue existante et on verra pour traduire les articles pertinents au besoin. Donc en général, ça va faire :
Je mets ça là en attendant de trouver une meilleure place (c'est un tout premier jet à complèter/corriger au fur et à mesure) :
#PCv5 Wiki architecture
Voici résumé les data actuellement disponibles et disséminées dans diverses localisations sur Planète Casio et/ou des sites partenaires. Le but du présent document est de faire un premier inventaire de ce qui est disponible et de réfléchir à la structuration possible des données pour transfert vers la v5 du site de Planète Casio.
Si besoin d'une mise à jour, ceci sera précisé (via le tag [MaJ]) ainsi que la disponibilité "linguistique" en français (tag [FR]) et/ou en anglais (tag [EN])
En particulier une revue des données disponibles sur :
seront reprises avec possiblement croisement avec d'autres sources (si possible mettre les liens vers les pages adhoc).
Révision du présent document
Plan du Wiki
Page de départ (à construire) donnant accès aux thèmes macro du wiki :
Données techniques et comparatifs des modèles de casio :
Utiliser sa machine :
Programmer sur sa machine :
Pour le comparatif de caltos, on a déjà CalcDB. On peut imaginer l'ajouter à PCv5-extra. (Cf #143)
Pour la frise je me note de l'ajouter à l'export de CalcDB à partir des données déjà présentes (quitte à les compléter). Un dépôt pour les unifier tous (comparateur et frise), ça évitera de se perdre.
De manière générale, je pense qu'il est bien de distinguer 4 catégories de documents :
Cf https://documentation.divio.com/
La référence, on l'a plus ou moins avec la liste des fonctions Basic Casio. Y'a du boulot de mise en page / mise à jour, mais les grandes lignes sont là.
Plus ajouter la référence des commandes pas Basic Casio (dans les autres apps typiquement, genre Run/Mat, Graph, Table etc.)
Éventuellement intégrer le comparatif des caltos là dedans.
Idem pour les manuels.
Les tutos, je note de compiler les tutos du mercredi (excellente base ❤️) plus ceux qui trainent sur différents sujets.
À ceci on peut ajouter les
Les how-to, on a en quelques uns sur des sujets comme réinitialiser le View-Windows. Je pense que cette partie est celle qui est la plus complexe à compiler parce que y'en a probablement un peu partout (donc une bonne partie dans le forum trucs et astuces).
Les explications… y'a des infos dans la Bible (comment fonctionne la calto), un peu sur le forum (comment fonctionne l'interpréteur Basic), etc. Sur ce point je sais pas trop comment organiser le truc.
Par rapport à cela, je ne sais pas si c'est intéressant de hiérarchiser le futur wiki comme cela, juste qu'à mon sens il faut qu'on puisse faire une recherche rapide selon le type de contenu qu'on cherche. Quelques cas d'usage :
Ça peut être par hiérarchie, par tag ou autre, mais à mon sens c'est important.
Idem si on peut filtrer par calculatrice ou langage ça peut être très chouette.
My 2 cents
@Darks En fait le framework de documentation de Divio est un fork de celui de Diátaxis, comme me l'a signalé un architecte à mon taf :)
https://diataxis.fr/
Note pour plus tard :
avec le "nouvel" Addin MathTS remis à plat par Lephé et compatible avec l'importation de fichier TeX-like, une section cours/documents à télécharger pourra peut être à terme faire partie du contenu téléchargeable à côté des usuels programmes de Planète Casio.
Il faut voir ça comme une version "easy" des eActs.
Rien de structuré pour le moment, juste un pense bête pour réfléchir et voir si intérêt à terme.