72 lines
11 KiB
Plaintext
72 lines
11 KiB
Plaintext
|
# Refonte de Framadate avec API
|
||
|
|
|
||
|
|
Il était une fois Framadate, une petite histoire de télétravail hors pandémie de Covid-19. Comme beaucoup de boulots collaboratifs de logiciels libre, c'est une contribution faite à distance, par beaucoup de personnes dans le monde, sur leur temps libre. De quoi apprendre des choses utiles en ces temps où le télétravail semble être totalement nouveau, alors que **pour beaucoup de contributeurs au libre, le travail de loin à plusieurs a toujours été l'unique façon de faire**. Donc Framadate, installé sur
|
||
|
|
=> https://framadate.org/ framadate.org
|
||
|
|
{mce-href="
|
||
|
|
=> https://framadate.org/%22%7D
|
||
|
|
, c'est comme Doodle (qui est devenu très cher pour le commun des mortels), mais en mieux du point de vue éthique.
|
||
|
|
|
||
|
|
## Qu'est-ce que c'est, Framadate?
|
||
|
|
|
||
|
|
=> https://www.cipherbliss.com/wp-content/uploads/2020/04/framadate_date.jpg [IMG]
|
||
|
|
{.aligncenter .size-full .wp-image-1398 mce-src="
|
||
|
|
=> https://www.cipherbliss.com/wp-content/uploads/2020/04/framadate_date.jpg
|
||
|
|
" width="446" height="300"}
|
||
|
|
=> https://www.cipherbliss.com/wp-content/uploads/2020/04/framadate_classic.jpg [IMG]
|
||
|
|
{.aligncenter .size-full .wp-image-1397 mce-src="
|
||
|
|
=> https://www.cipherbliss.com/wp-content/uploads/2020/04/framadate_classic.jpg
|
||
|
|
" width="446" height="300"}C'est un petit logiciel que vous pouvez installer sur votre serveur afin de permettre à n'importe qui d'organiser des sondages pour se faire des rendez-vous (au lieu d'utiliser la technique moisie des échanges interminables d'email "moi je suis dispo tel jour" "ha moi non" "ah moi oui" "oui mais toi on s'en fout Bébert!" ... pauvre Bébert!), sans que les gens que vous souhaitiez réunir n'aient besoin de s'sinscrire, de faire chauffer la carte bleue, ou de se faire pister par les GAFAM.C'est un logiciel très utilisé, mais qui souffre de problème d'ergonomie énorme sur mobile. Comme beaucoup de projets libres, faits par des gens qui ne sont pas experts en User eXperience, design, accessibilité, traduction. Il était question de retaper son front end depuis un bout de temps, et Maiwann s'est lancé dans la réunion d'idées en 2018, a produit des design d'écrans en 2019, et fait un appel a discuter du truc avec le hashtag #framadate, depuis un post Mastodon en Aout 2019. Les maquettes étaient prêtes et n'attendaient qu'à être traduites en logiciel.
|
||
|
|
|
||
|
|
::: iframe ::: {#mastodon-status props="{"locale":"fr","id":"102542430632339251"}"} :::
|
||
|
|
|
||
|
|
::: {.logo-resources aria-hidden="true" inert="" tabindex="-1"}
|
||
|
|
=> data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iNzkiIGhlaWdodD0iNzkiIHZpZXdib3g9IjAgMCA3OSA3NSI+PHN5bWJvbCBpZD0ibG9nby1zeW1ib2wtaWNvbiI+PHBhdGggZD0iTTc0LjcxMzUgMTYuNjA0M0M3My42MTk5IDguNTQ1ODcgNjYuNTM1MSAyLjE5NTI3IDU4LjEzNjYgMC45NjQ2OTFDNTYuNzE5NiAwLjc1Njc1NCA1MS4zNTEgMCAzOC45MTQ4IDBIMzguODIyQzI2LjM4MjQgMCAyMy43MTM1IDAuNzU2NzU0IDIyLjI5NjYgMC45NjQ2OTFDMTQuMTMxOSAyLjE2MTE4IDYuNjc1NzEgNy44Njc1MiA0Ljg2NjY5IDE2LjAyMTRDMy45OTY1NyAyMC4wMzY5IDMuOTAzNzEgMjQuNDg4OCA0LjA2NTM1IDI4LjU3MjZDNC4yOTU3OCAzNC40Mjg5IDQuMzQwNDkgNDAuMjc1IDQuODc3IDQ2LjEwNzVDNS4yNDc5MSA0OS45ODE3IDUuODk0OTUgNTMuODI1MSA2LjgxMzI4IDU3LjYwODhDOC41MzI4OCA2NC41OTY4IDE1LjQ5MzggNzAuNDEyMiAyMi4zMTM4IDcyLjc4NDhDMjkuNjE1NSA3NS4yNTkgMzcuNDY4IDc1LjY2OTcgNDQuOTkxOSA3My45NzFDNDUuODE5NiA3My43ODAxIDQ2LjYzODEgNzMuNTU4NiA0Ny40NDc1IDczLjMwNjNDNDkuMjczNyA3Mi43MzAyIDUxLjQxNjQgNzIuMDg2IDUyLjk5MTUgNzAuOTU0MkM1My4wMTMxIDcwLjkzODQgNTMuMDMwOCA3MC45MTc4IDUzLjA0MzMgNzAuODk0MkM1My4wNTU4IDcwLjg3MDYgNTMuMDYyOCA3MC44NDQ1IDUzLjA2MzcgNzAuODE3OVY2NS4xNjYxQzUzLjA2MzQgNjUuMTQxMiA1My4wNTc0IDY1LjExNjcgNTMuMDQ2MiA2NS4wOTQ0QzUzLjAzNSA2NS4wNzIxIDUzLjAxODkgNjUuMDUyNSA1Mi45OTkyIDY1LjAzNzFDNTIuOTc5NCA2NS4wMjE4IDUyLjk1NjQgNjUuMDExIDUyLjkzMTggNjUuMDA1NkM1Mi45MDczIDY1LjAwMDIgNTIuODgxOSA2NS4wMDAzIDUyLjg1NzQgNjUuMDA1OUM0OC4wMzY5IDY2LjE0NzIgNDMuMDk3MSA2Ni43MTkzIDM4LjE0MSA2Ni43MTAzQzI5LjYxMTggNjYuNzEwMyAyNy4zMTc4IDYyLjY5ODEgMjYuNjYwOSA2MS4wMjc4QzI2LjEzMjkgNTkuNTg0MiAyNS43OTc2IDU4LjA3ODQgMjUuNjYzNiA1Ni41NDg2QzI1LjY2MjIgNTYuNTIyOSAyNS42NjcgNTYuNDk3MyAyNS42Nzc1IDU2LjQ3MzhDMjUuNjg4IDU2LjQ1MDIgMjUuNzAzOSA1Ni40Mjk1IDI1LjcyNCA1Ni40MTMyQzI1Ljc0NDEgNTYuMzk3IDI1Ljc2NzggNTYuMzg1NiAyNS43OTMxIDU2LjM4MDFDMjUuODE4NSA1Ni4zNzQ2IDI1Ljg0NDggNTYuMzc1MSAyNS44Njk5IDU2LjM4MTZDMzAuNjEwMSA1Ny41MTUxIDM1LjQ2OTMgNTguMDg3MyA0MC4zNDU1IDU4LjA4NkM0MS41MTgzIDU4LjA4NiA0Mi42ODc2IDU4LjA4NiA0My44NjA0IDU4LjA1NTNDNDguNzY0NyA1Ny45MTkgNTMuOTMzOSA1Ny42NzAxIDU4Ljc1OTEgNTYuNzM2MUM1OC44Nzk0IDU2LjcxMjMgNTguOTk5OCA1Ni42OTE4IDU5LjEwMyA1Ni42NjExQzY2LjcxMzkgNTUuMjEyNCA3My45NTY5IDUwLjY2NSA3NC42OTI5IDM5LjE1MDFDNzQuNzIwNCAzOC42OTY3IDc0Ljc4OTIgMzQuNDAxNiA3NC43ODkyIDMzLjkzMTJDNzQuNzkyNiAzMi4zMzI1IDc1LjMwODUgMjIuNTkwMSA3NC43MTM1IDE2LjYwNDNaTTYyLjk5OTYgNDUuMzM3MUg1NC45OTY2VjI1LjkwNjlDNTQuOTk2NiAyMS44MTYzIDUzLjI3NyAxOS43MzAyIDQ5Ljc3OTMgMTkuNzMwMkM0NS45MzQzIDE5LjczMDIgNDQuMDA4MyAyMi4xOTgxIDQ0LjAwODMgMjcuMDcyN1YzNy43MDgySDM2LjA1MzRWMjcuMDcyN0MzNi4wNTM0IDIyLjE5ODEgMzQuMTI0IDE5LjczMDIgMzAuMjc5IDE5LjczMDJDMjYuODAxOSAxOS43MzAyIDI1LjA2NTEgMjEuODE2MyAyNS4wNjE3IDI1LjkwNjlWNDUuMzM3MUgxNy4wNjU2VjI1LjMxNzJDMTcuMDY1NiAyMS4yMjY2IDE4LjExOTEgMTcuOTc2OSAyMC4yMjYyIDE1LjU2OEMyMi4zOTk4IDEzLjE2NDggMjUuMjUwOSAxMS45MzA4IDI4Ljc4OTggMTEuOTMwOEMzMi44ODU5IDExLjkzMDggMzUuOTgxMiAxMy40OTIgMzguMDQ0NyAxNi42MTExTDQwLjAzNiAxOS45MjQ1TDQyLjAzMDggMTYuNjExMUM0NC4wOTQzIDEzLjQ5MiA0Ny4xODk2IDExLjkzMDggNTEuMjc4OCAxMS45MzA4QzU0LjgxNDMgMTEuOTMwOCA1Ny42NjU0IDEzLjE2NDggNTkuODQ1OSAxNS41NjhDNjEuOTUyOSAxNy45NzQ2IDYzLjAwNjUgMjEuMjI0MyA2My4wMDY1IDI1LjMxNzJMNjIuOTk5NiA0NS4zMzcxWiIgZmlsbD0iY3VycmVudENvbG9yIj48L3BhdGg+PC9zeW1ib2w+PHVzZSB4bGluazpocmVmPSIjbG9nby1zeW1ib2wtaWNvbiI+PC91c2U+PC9zdmc+ [IMG]
|
||
|
|
::: :::
|
||
|
|
|
||
|
|
[]{.mce-shim}Nouvelle tête de framadate, maquettes sur Zeplin, cette version n'est pas encore en production:
|
||
|
|
=> https://www.cipherbliss.com/wp-content/uploads/2020/04/Screenshot_2020-04-10-Zeplin-Project.png [IMG]
|
||
|
|
{.aligncenter .size-full .wp-image-1401 mce-src="
|
||
|
|
=> https://www.cipherbliss.com/wp-content/uploads/2020/04/Screenshot_2020-04-10-Zeplin-Project.png
|
||
|
|
" width="1025" height="807"}
|
||
|
|
|
||
|
|
## Comment on fait pour contribuer à plusieurs à distance?
|
||
|
|
|
||
|
|
Avec d'autres gens recrutés de divers moyens avec des posts sur des forums et des médias sociaux de toutes sortes. Des gens répondent à l'appel, et c'est parti!
|
||
|
|
|
||
|
|
## Communication interne
|
||
|
|
|
||
|
|
En premier lieu il faut savoir comment communiquer avec les autres contributeurs. , on a discuté du truc d'abord sur les réseaux sociaux et forums d'où ont été faits les appels. Quel moyen on devrait privilégier pour échanger tout le long du projet? Celui qui convient à le plus de gens motivés.Riot, IRC, forum framacolibri, Wire, Mattermost, les possibilités sont nombreuses, mais c'est le Mattermost de Framasoft, Framateam, section UX & Libre, canal framadate qui a remporté le plus de votes. Grâce à mon gestionnaire de mots de passe, créer un compte avec un mot de passe réellement complexe (une centaine de caractères divers et variés) ne me fait pas peur. Mattermost ci propose en plus l'avantage de pouvoir se connecter via le Gitlab de Framasoft, Framagit, qui héberge tous les code sources des projets. C'est aussi un excellent moyen d'avoir plusieurs autres outils utiles à un projet logiciel: disposer d'un wiki, et d'un tableau de choses à faire avec les Issues, au sein desquelles on peut aussi discuter des détails.Il a été convenu aussi qu'on allait donner des informations pour accueilir les nouveaux contributeurs dans la desciption du
|
||
|
|
=> https://framateam.org/ux-framatrucs/channels/framadate canal framateam nommé Framadate
|
||
|
|
{mce-href="
|
||
|
|
=> https://framateam.org/ux-framatrucs/channels/framadate%22%7D
|
||
|
|
, et que l'on allait cantonner les discussions de dev dans un canal séparé pour ne pas faire fuir les gens normaux, sur :
|
||
|
|
=> https://framateam.org/ux-framatrucs/channels/framadate-dev framadate-dev
|
||
|
|
{mce-href="
|
||
|
|
=> https://framateam.org/ux-framatrucs/channels/framadate-dev%22%7D.
|
||
|
|
|
||
|
|
### Quels sont les objectifs, par où puis-je commencer?
|
||
|
|
|
||
|
|
Il nous faut aussi savoir ce qu'on veut faire, pour savoir quelles compétences rechercher et comment indiquer aux gens qui le souhaitent comment ils peuvent aider le projet. C'est un gros travail de discussion et de communication. Certains ont l'habitude de faire ça en vrai, dans des ateliers de contribution où des gens de tous âges et de tout poil viennent discuter, sociabiliser, boire un coup, et des fois même, écrire, dessiner, coder des trucs.Les maquettes sont prêtes, on peut les faire évoluer, on est prêts aussi à les confronter à la réalité.
|
||
|
|
|
||
|
|
|
||
|
|
### Accueillir les gens est primordial
|
||
|
|
|
||
|
|
c'est sur nos premiers ressenti que l'on va décider si on a envie d'investir deux minutes dans un projet en ligne avec des gens que l'on ne connaît ni d'ève ni d'adam. Ensuite, comprendre qu'on a le droit de poser des questions et d'ignorer des choses, et qu'on peut aider sans avoir aucune compétence logicielle, ça fait un bien fou.Pour savoir ce que l'on peut faire on a créé au début un pad collaboratif. Puis une fois qu'on a fait le ménage dans nos idées, on a mis ça dans le wiki du dépot gitlab.Au début on a envisagé de ne retaper que le style. Puis en discutant avec des gens qui connaissaient bien le code existant, et en examinant d'un côté ce que ça nous prendrait comme temps de retaper ce qui existe, ou repartir de zéro avec un framework comme on a conclu qu'il valait mieux partir de zéro et utiliser quelques bibliothèques logicielles à assembler pour se concentrer sur le code métier.Ensuite, ça se fait au fil de l'eau, l'important étant que chacun trouve son compte et soit prêt à faire des concessions pour avancer. oui moi aussi, c'est fou je sais.
|
||
|
|
|
||
|
|
## Relancer régulièrement les motivés
|
||
|
|
|
||
|
|
Une fois les gens mobilisés, il faut identifier ce qui les bloque, car bien souvent on hésite à dire quand quelque chose ne va pas. Relancer fait partie du boulot pour bosser en équipe, même si on a pas du tout un statut d'animateur ou de manager officiel.Un gros boulot de refacto pour bien séparer les concepts, les types, faire des modèles documentés dans le code ont été réalisés pendant le confinement de 2020. Quelques petites réunions vocales en équipe ont permis d'avancer sur les points les plus techniques. La bêta n'est pas encore sortie.Mais vous pouvez déjà demander à l'API ce qu'elle fait, j'ai mis une version de démo sur
|
||
|
|
=> https://framadate-api.cipherbliss.com framadate-api.cipherbliss.com
|
||
|
|
/api/v1voici le document qui liste la config au format JSON:
|
||
|
|
=> https://framadate-api.cipherbliss.com/api/doc.json https://framadate-api.cipherbliss.com/api/doc.json
|
||
|
|
Vous pouvez venir voir comment on avance sur les dépots framagit, et sur
|
||
|
|
=> https://framateam.org/ux-framatrucs/channels/framadate les canaux de discussion de Framateam, section UX & Design
|
||
|
|
. Enjaillez!
|
||
|
|
|
||
|
|
# Métadonnées
|
||
|
|
|
||
|
|
:PROPERTIES: :ID: c3faeefc-be57-443e-9b27-e1d9e0ecb93d :END: #+title: refonte-de-framadate-avec-api #+post_ID: 1437 #+post_slug: refonte-de-framadate-avec-api #+post_url:
|
||
|
|
=> https://www.ciperbliss.com/2020/refonte-de-framadate-avec-api
|
||
|
|
#+post_title: Refonte de Framadate avec API #+post_type: post #+post_mime_types: #+post_guid:
|
||
|
|
=> https://www.cipherbliss.com/?p=1437
|
||
|
|
#+post_status: publish #+post_date_published: <2020-07-14 14:03:05> #+post_date_modified: <2020-07-14 14:03:10> #+post_index_page_roam_id: [[id:eb3564de-713d-46a7-b69f-dc25e6cc2093][undefined]] #+retrieved_from_db_at: <2024-11-07 22:21:40>
|