AccueilActualitésDéveloppementDécouvrez comment documenter simplement vos API et ressources avec Slate Développement Découvrez comment documenter simplement vos API et ressources avec Slate Publié le 21/01/2015 Partager cet article : Partager sur Facebook Partager sur Twitter Partager sur Linkedin Share on pinterest Vous avez publié une ressource ou une application Web et avez besoin d'aide pour documenter son API . Slate est là pour vous aider à mettre votre documentation en ligne ! Documentez votre application avec Slate Slate est une application JS qui vous permettra de créer et mettre en forme très simplement une documentation pour l'API de votre service ou d'une ressource de votre création. Doté d'une interface très propre et responsive, Slate est une des documentations les plus agréables à l'oeil. Le fait qu'elle soit organisé sous forme d'une one page permet d'utiliser le ctrl-F si vous êtes un barbu, et une recherche en Javascript existe sur le côté gauche si ce n'est pas dans vos habitudes. De plus, la présence de deep-linking permet de garder en signet des parties précises de la documentation, un des gros manque des one-page en général. Pour vous aider à visualiser l'application, je vous propose de faire un tour sur cette documentation exemple. Enfin, gros point positif, Slate n'est fait que de Markdown. Pas besoin de perdre du temps en formation, vous pourrez l'utiliser directement si vous êtes un familier du langage, et après 5 minutes de formation au markdown dans le cas contraire. Installation et utilisation L'installation de Slate est des plus simples : Copier le code sur son disque. installer les dépendances. démarrer le serveur de test. La création de votre documentation se fait ensuite très simplement avec un Markdown légèrement modifié. Une fois fini, il ne vous reste plus qu'à mettre votre documentation en ligne. Besoin d'un hébergement gratuit ? Cette page vous expliquera comment héberger votre documentation sur Github]. By Benjamin Sanchez Laisser un commentaire Annuler la réponseVotre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *Comment Nom * E-mail* Site web Enregistrer mon nom, mon e-mail et mon site dans le navigateur pour mon prochain commentaire.
Développement Créer des illustrations et animations avec une seule div, c’est possible ! Publié le 09/11/2016
Développement Quels sont les pour et les contres d’un Framework javascript fait maison ? Publié le 13/01/2015