Version Française - English Version

🇫🇷 Français

Durant le développement de Program, application mobile de planification de conférences et d’événements, nous avions besoin d’utiliser un champ d’édition de Markdown. En cherchant sur le gestionnaire de librairies, nous nous sommes rendu compte qu’aucune ne correspondait à nos besoins. Nous avons donc développé notre propre champ d’édition. Dans une initiative de Playmoweb de contribuer à l’Open Source, nous avons par la suite décidé de mettre cette librairie à disposition de la communauté Flutter.

De quoi s’agit-il ?

Markdown Editable TextInput est un champ d’édition permettant de simplifier l’écriture de texte en Markdown. La librairie est développée en Flutter et est disponible sur le gestionnaire de paquets Dart / Flutter. Flutter est un framework Dart permettant de développer des applications crossplateformes Android/iOS/Web/Desktop. Chez Playmoweb, nous utilisons de plus en plus ce framework pour nos applications.

Comment le mettre en place ?

L’enjeu d’une librairie Open Source est son utilisation par d’autres utilisateurs. Il faut donc que sa documentation soit la plus précise et claire possible. Notre documentation se compose donc d’une brève description, une liste de fonctionnalités disponibles et à venir, une démonstration sous forme de GIF, ainsi que les attributs utilisables. Un suivi de version doit aussi être disponible, définissant la date, la version et une description des changements effectués. Le choix d’une licence est obligatoire afin de définir les termes d’utilisation du package. Pour publier une librairie, il sera donc nécessaire de remplir tous ces pré-requis. L’implémentation de tests n’est pas obligatoire mais reste cependant importante. Couplée à un système d’intégration continue, elle permet d’assurer à l’utilisateur que la librairie restera fonctionnelle au gré des mises à jour.

Une fois la librairie déployée, elle dispose de plusieurs critères d’évaluation, permettant à l’utilisateur d’évaluer la qualité de celle-ci. Par la suite, n’importe qui peut proposer des évolutions, reporter des bugs ou exposer ses problèmes d’utilisation depuis notre répertoire GitHub

Nous avons déjà quelques utilisateurs et demandes d’évolutions, alors n’hésitez pas vous aussi à utiliser et faire des retours sur notre librairie ! Si vous êtes développeur·euse, vous pouvez égalemment développer des fonctionnalités supplémentaires et nous attribuer les Pull Request pour les ajouter à la librairie.

🇺🇸 English

While developing Program, a mobile application to plan conferences and events, we needed to use a text input to edit Markdown. After searching on the packages manager, we felt like nothing looked like what we wanted. That’s why we decided to develop our own thing. What’s more, that was a time when Playmoweb decided to contribute more to the Open Source world. So we published it and made it available for the Flutter community to use.

What is it ?

Markdown Editable TextInput is, as says its name, a text field aiming to simplify the edition of markdown text. It’s built in Flutter and available on the Dart / Flutter package manager. Flutter is a Dart framework used to create cross-platform application on Android/iOS/Web/Desktop. At Playmoweb, we use this framework more and more on our applications.

How to make it happened ?

The main goal of an Open Source package is being used by other users. This means that its documentation needs to be as precise and as clear as possible. Our documentation is then composed of a brief description, a list of available and upcoming features, a GIF demo, and the needed attributes to work. A change log also needs to be present, defining the date, version and description of the changes that happened with each new version. The choice of a license is crucial and mandatory, allowing us to choose the terms of uses of our package. So in order to publish our package, we need to complete all these prerequisites. Also, test implementation is not mandatory but still is really important. Coupled with continuous integration, it assures that the package remains functional with each update.

Once our package deployed, it disposes of many indicators allowing a user to evaluate its quality. Then, anybody can suggest features, report bugs or talk about the problems they can encounter from our GitHub repository

We already have some users and requests of evolutions so don’t hesitate to use and give us feedback on our package too ! If you’re a developer, you can also develop additional features and assign us the Pull Request to add it to the library.