Bienvenue sur le profil Malt de Florence !
Localisation et déplacement
- Localisation
- Paris, France
- Télétravail
- Effectue ses missions majoritairement à distance
Préférences
- Secteur d'activité
-
- Edition de logiciels
- Agence & SSII
- Internet des objets
Vérifications
Charte du freelance Malt signée
Consulter la charte
Langues
Compétences (22)
Florence en quelques mots
Spécialiste de la documentation en ligne (Markdown + SSG) -- Français et Anglais.
De la start-up au grand compte, avec projet technique motivant.
- Pour les start-ups : Création de votre documentation "from scratch", y compris mise en place de process, et évolution pour vous accompagner dans votre croissance. La Technical Due Diligence se base d'autant plus sur la documentation que les développements sont peu avancés. Seule ou en tant que Head of Documentation.
- Pour les PME et grands-groupes : adaptation à ou prise en main de la documentation existante, refonte et amélioration, accompagnement, selon vos besoins. Gestion d'équipe.
- Management / Collaboration : Jira, Notion, vos outils ou workspaces Agile...
- Docs-as-Code : GitHub/GitLab/Gitea, GitBash, Sourcetree, VS Code, Swagger.io, outils générant de la doc à partir de commentaires, ...
- Doc en ligne : Markdown et générateur de site statique (Docusaurus 1 et 2, Hugo, ReDoc, ...), HTML & CSS Notion,...
- Schémas : Miro, Excalidraw, diagrams.net,...
- Fondamentaux : Office, Adobe Solution for Technical Content, retouche/création d'images, et plus encore.
=Mots-clés des missions depuis février 2019=
CRM -- Data Mining, Data Analysis, LC/NC -- IP stack, SCHC, LPWAN, IoT -- Data Curation, Edge Computing, Computing Continuum, Embedded Systems -- REST APIs, SaaS applications -- 3D modeling and assembly -- Personal authentication via biometrics.
Mon profil, mes services, mon portfolio (mes dernières missions notamment) sont détaillés en français et en anglais sur mon site web Coffeecup.tech.
A bientôt !
Portfolio
Expériences
Coheris
Edition de logiciels
Senior Technical Writer - En tant que freelance
Création d'un site Web de documentation.
Actuellement : doc d'installation, doc des APIs.
Fonctionnement Docs-as-Code pour intégration/collaboration avec la R&D.
Acklio
Edition de logiciels
Senior Technical Writer
Voir ci-dessous pour des informations détaillées sur Acklio et ma mission initiale pour eux.
Mots-clés de la mission : IP stack, SCHC, LPWAN, IoT
Acklio
Edition de logiciels
Senior Technical Writer - En tant que freelance
Voir ci-dessous pour plus de détail sur Acklio et ma mission initiale pour eux.
Mots-clés de la mission : IP stack, SCHC, LPWAN, IoT
Société dans le régalien
Edition de logiciels
Senior Technical Writer - En tant que freelance
La société développe des applications de préparation de données, exploration de données et analyse de données pour le régalien.
Ne disposant d'aucun document de départ, j'ai eu à mettre sur pied un ensemble documentaire regroupant des informations de communication autour des applications, un manuel d'installation, un manuel utilisateur pour une des applications, et une bonne partie du manuel d'administration de ces applications.
J'ai également conçu et rendu accessible dans la documentation un ensemble de processus low-code à l'appui du manuel utilisateur ainsi qu'un tutoriel complet sur un work-flow que j'ai conçu pour être le plus didactique possible.
J'ai réalisé de nombreux schémas illustrant tant l'architecture que les concepts ou les work-flow des applications.
Pour le manuel d'installation, j'ai également fourni une version jumelle sous forme de site Web en HTML/CSS pur pour une utilisation autonome sans connexion Internet.
La réalisation de cette mission dans un temps défini de 78 jours a demandé beaucoup d'autonomie, d'efficacité et d'adaptation.
J'ai proposé Docusaurus v2 pour créer le site Web afin d'obtenir le plus rapidement possible un résultat professionnel.
La mission a été réalisée en mode docs-as-code dans un environnement Microsoft Azure.
Au final, le client a eu un résultat au-delà de ses attentes.
Il dispose maintenant d'un site Web de documentation respectant sa charte graphique, très professionnel, avec moteur de recherche intégré, regroupant communication, installation, administration et prise en main.
Pour ce site, j'ai rédigé 86 fichiers de contenu, créé 22 schémas et fait 642 captures d'écrans et autres illustrations, et codé 37 processus. Sans compter l'adaptation des fichiers de structure, la CSS et l'énorme fichier de sidebar.
Mots-clés de la mission : Data Mining, Data Analysis, Low-Code/No-Code.
Acklio
Edition de logiciels
Senior Technical Writer - En tant que freelance
Voir ci-dessous pour des informations détaillées sur Acklio et ma mission initiale pour eux.
Mots-clés de la mission : IP stack, SCHC, LPWAN, IoT
Lineberty
Edition de logiciels
Senior Technical Writer - En tant que freelance
Voir ci-dessous pour des informations détaillées sur Lineberty et ma mission initiale pour eux.
Mots-clés de la mission : digital queuing, SaaS, API Rest
Acklio
Edition de logiciels
Senior Technical Writer - En tant que freelance
Acklio promeut et développe des normes et des logiciels pour les réseaux étendus à faible consommation, spécialement conçus pour LoRaWAN, SIGFOX, NB-IoT et LTE-M. La technologie SCHC a été publiée en tant que standard RFC IETF en avril 2020.
Dans cette première phase, j'ai créé le site Web de la Documentation d'Acklio (en anglais) présentant 3 catégories d'information : généralités sur SCHC et les réseaux LPWAN, informations produits sur la suite logicielle d'Acklio, documentation des cas d'usages.
Disposant d'un existant écrit fourni mais hétérogène sur Confluence (auteurs multiples), ainsi que de fichiers sources sur GitLab, l'enjeu de départ a été de s'immerger dans l'éco-système technologique bien particulier d'Acklio pour maîtriser le sujet le plus rapidement possible. J'ai lu énormément de documents et fait de très nombreuses recherches pour m'auto-former.
Ensuite, le travail a consisté à utiliser l'application, analyser et trier les informations utiles, faire des arbitrages, rajouter du contenu (textes et visuels), homogénéiser les informations pour obtenir un tout cohérent avec un axe de lecture didactique clair.
A la fin de la mission, Acklio disposait d'un site Web complet répondant parfaitement à ses attentes, ainsi que de fichiers Readme détaillés. L'audience cible était un public expert des réseaux LPWAN et IP.
Site Web réalisé avec Docusaurus V2. Contenu rédigé dans Visual Studio Code et poussé sur GitLab en utilisant Sourcetree.
42 pages en Markdown. 105 fichiers images (réalisés principalement avec Excalidraw). CSS et fichiers de structure (dont sidebar) personnalisés.
Mots-clés de la mission : IP stack, SCHC, LPWAN, IoT
Heex Technologies - France AutoTech
Edition de logiciels
Senior Technical Writer - En tant que freelance
Dans cette 2ème phase, j'ai créé le site Web de la Documentation de Heex (en anglais), avec 3 niveaux de lectures : "public", "avancé" et "experts".
- Site réalisé avec Docusaurus V2. Architecture, structuration, adaptation aux 3 entrées différentes.
- Rédaction du contenu à partir de l'existant rédigé en phase 1, souvent reformulation en fonction des trois types d'audience. Les contenus sont tous complexes par essence.
- 57 nouveaux schémas réalisés avec Excalidraw.
- Favicon, images, CSS, styling, etc.
- Commit/push sur GitLab.
Mots-clés de la mission : Data Management, Data Curation, Edge Computing, Cloud Computing, Computing Continuum, Embedded Systems, REST APIs, SaaS applications.
Heex Technologies - France AutoTech
Edition de logiciels
Senior Technical Writer - En tant que freelance
J’ai eu pour mission de créer la première documentation technique (en anglais) de la solution Heex, à partir de schémas Miro et du code source.
Cette documentation concernait deux des trois éléments de la solution Heex, ceux au plus proche du code : le SDK pour les systèmes embarqués et l’API REST de distribution entre le backend et le frontend.
-> Pour la partie SDK, j’ai du remonter l’information du code C++ lui-même (modules et librairies) pour concevoir, structurer et rédiger un Readme complet fourni dans le repository sur GitLab.
-> Pour la partie API REST, j’ai du parcourir tous les fichiers javascript des contrôleurs HTTP et des routes pour créer la documentation de référence du Swagger, et la documentation utilisateur.
-> Pour les deux, j’ai du réaliser de très nombreux schémas d’architectures à partir des schémas de spécifications réalisés sous Miro par Heex. Il s’agissait là d’un travail de simplification d’une pensée complexe, avec pour destinataires aussi bien des développeurs que des business partners.
En plus de cette mission, j’ai créé pour Heex un Workspace Notion dédié à la Documentation afin de :
- fournir une vue publique de mon travail de documentation (Notion a une gestion des accès très pertinente),
- avoir un espace de gestion de mon projet similaire à Jira : Roadmap, dashboards collaboratifs, base de données de contenu texte et images, etc.
Dans la phase de démarrage ("seed") où se trouve Heex actuellement, une documentation sous Notion constitue une excellent alternative à un site web documentaire.
Ce type de Workspace est également très utile pour une jeune start-up pour passer sa Technical Due Diligence, la documentation jouant un rôle d’autant plus majeur que les développements ne sont pas finalisés.
Mots clés de la mission Notion, SDK (C++), REST API (Javascript et JSON), Swagger, Visual Studio Code, Markdown, GitLab, Sourcetree, Miro, Notion, Draw.io, anglais.
Lineberty
Edition de logiciels
Rédactrice Technique Senior - En tant que freelance
La mission a aussi eu pour but de migrer la documentation utilisateur (faite avec Hugo, voir ci-dessous) vers Docusaurus v2, la documentation de Lineberty étant appelée à grossir.
Le choix s’est porté vers Docusaurus v2 pour son framework avancé de documentation en ligne qui utilise des fichiers Markdown.
Ses points forts sont la navigation, le moteur de recherche, des options de style séduisantes et une personnalisation plutôt facile.
Enfin, un plugin ReDoc pour Docusaurus permet d’accéder aux OpenAPIs de Lineberty directement depuis le portail unique de la nouvelle documentation. Une intégration très réussie !
Cette migration vers Docusaurus v2 a été l’occasion d’une revue complète de la documentation, avec une nouvelle page d’accueil et de nouvelles icônes, une nouvelle structure et de nouveaux schémas.
Mots clés de la mission
Docusaurus, REST API, Swagger, Visual Studio Code, Markdown, Draw.io, ReDoc, GitHub, Sourcetree, anglais.
3DVia
Edition de logiciels
Rédactrice Technique Senior - En tant que freelance
- définition de la nouvelle architecture et du process;
- conversion du HTML vers le Markdown;
- revue approfondie (réécriture, restructuration, nouveaux schémas, etc.) de sections complètes de la documentation;
- travail en collaboration avec les équipes sur place et en Inde.
Rédaction d'un tutoriel transverse utilisant toutes les applications 3DVia de géometrie, d'assemblage et d'interface avec la base de données (document entièrement nouveau). Y compris création d'un meuble avec ces applications et réalisation de nombreuses captures d'écrans.
Revue d'une partie de l'API (REST).
Travail en anglais.
IDEMIA - La Poste Groupe
Edition de logiciels
Rédactrice Technique Senior - En tant que freelance
Les applications de gestion des frontières d'Idemia s'appuient sur des technologies de pointe incluant l'intelligence artificielle, la biométrie ou la cryptographie.
La mission a consisté à :
- Restructurer, réécrire et uniformiser la documentation logicielle
- Mettre à jour la documentation et ses captures d'écrans
- Travailler en mode projet avec un objectif de portabilité
Les mots-clés de la mission sont : application Web, GUI, FrameMaker, Word.
Lineberty
Edition de logiciels
Rédactrice Technique Senior - En tant que freelance
Cette API REST permet à des entreprises de créer leur propre application de réservation. Le point commun de ces entreprises est qu’elles ont à gérer des files d’attente. Il peut s’agir de centres commerciaux, grands magasins, parcs d’attractions, sites touristiques, aéroports, etc.
L’application de reservation peut être une application mobile ou accessible sur une borne.
La mission a consisté à :
- Réécrire et améliorer la documentation de l’OpenAPI existante (en anglais). Travail dans Swagger Editor et Template ReDoc.
- Réécrire et améliorer le Guide utilisateur de l’API Lineberty (en anglais). Travail en Markdown dans Visual Studio Code et template Hugo.
Après ce travail, la documentation de l'API REST de Lineberty est désormais "DOCfull" : jeu de mot de mon invention en clin d'oeil à RESTful et signifiant que l'API dispose d'un ensemble complet composé d'une doc de référence et une doc utilisateur.
--> Voir https://www.coffeecup.tech/fr/portfolio1/lineberty_rest/ et https://www.coffeecup.tech/fr/service/rest_api_doc/
Florence Venisse
Edition de logiciels
Rédactrice Technique Freelance - En tant que freelance
C'est une longue expérience auprès de plus de 30 entreprises, la plupart basées en France mais aussi en Allemagne et au Royaume-Uni.
J'ai travaillé sur de très nombreux projets : applications B-to-B, applications B-to-C ; tous types de documents : papiers, en ligne, vidéos ; toutes sortes d'environnements : Windows, mais aussi MacOS et Linux (Mandrake).
--> Le détail sur ces expériences à la page https://www.coffeecup.tech/fr/portfolio2/previous_coffeecup/.
1 recommandation externe
Consultez les recommandations qu'a reçues Florence