Avis et détails du produit ReadMe

Nous construisons notre propre application d'investissement, et l'une des sociétés de compensation avec lesquelles nous travaillons utilise déjà ReadMe pour leur documentation, alors nous l'avons vérifié grâce à cette recommandation. Cela a été un excellent choix. Il est rapide de publier des documents propres et modernes, la synchronisation OpenAPI et la référence API interactive fonctionnent très bien, et il est facile pour les personnes techniques et non techniques de contribuer. Les analyses sont également vraiment utiles pour voir ce que les gens lisent et où nous pouvons rendre les choses encore plus claires. Avis collecté par et hébergé sur G2.com.

Rien n'est parfait, certaines des personnalisations plus poussées et des paramètres d'administration nous ont pris un moment à apprendre et pourraient être un peu plus intuitifs, mais les paramètres par défaut sont solides et le support a été réactif, donc cela ne nous a jamais ralentis. Une fois que vous êtes configuré, la publication et les mises à jour quotidiennes sont sans effort. Avis collecté par et hébergé sur G2.com.

J'aime que ce soit assez facile à configurer, et que ce soit visuellement très propre. Le branding est simple et les sections comme les guides par rapport à la référence API sont faciles à comprendre. Ces aspects rendent ReadMe très attrayant pour moi. Avis collecté par et hébergé sur G2.com.

Je voudrais avoir une meilleure façon de gérer la documentation API pour différents produits. Actuellement, je dois contourner les choses en créant une version différente et en faisant essentiellement que deux produits aient deux versions, mais ce n'est pas sémantiquement correct. Je préférerais avoir une méthode plus propre pour permettre la commutation entre plusieurs produits. De plus, il y a un problème agaçant où l'équipe financière ne peut pas avoir un rôle juste pour gérer des choses comme les méthodes de paiement pour nos paiements mensuels, donc ils continuent de me contacter. C'est le seul reproche que j'ai. Avis collecté par et hébergé sur G2.com.

Super facile à utiliser ! Les suggestions de modifications sont cool. Construire une page d'atterrissage professionnelle est un jeu d'enfant. Des insights puissants de l'API. Avis collecté par et hébergé sur G2.com.

Je pense que probablement parce qu'il est conçu pour être SI facile à utiliser, il est un peu moins flexible et s'enrichit en fonctionnalités plus lentement. Cela dit, il a fait des progrès récemment ! Avis collecté par et hébergé sur G2.com.

- Facile à démarrer

- Personnalisations de thème Avis collecté par et hébergé sur G2.com.

- Pour un produit de documentation, il a un éditeur incroyablement bogué. Oui, je comprends que construire un éditeur WYSIWYG est difficile, mais quand même, tous les éléments de l'interface utilisateur du menu continuent de sauter de manière erratique. Impossible d'indenter ou de désindenter correctement les éléments.

- Recherche terrible basée sur des mots-clés en 2024. 9 fois sur 10, les résultats de recherche sont mal classés.

- Ne prend pas en charge l'hébergement de pages HTML statiques arbitraires - Par exemple, générées à partir de Python Sphinx ou Mkdocs. Avis collecté par et hébergé sur G2.com.

Si vous recherchez une plateforme de documentation API exceptionnelle, ne cherchez pas plus loin que Readme. Cet outil a transformé notre manière de gérer la documentation API, offrant une expérience fluide pour les utilisateurs finaux et les développeurs.

L'interface épurée de Readme et sa navigation intuitive la rendent parfaite pour nos clients qui recherchent une intégration fluide avec les API, leur permettant de l'essayer en déplacement et de voir les opportunités. Le support pour les pages et sections personnalisées nous a fait gagner du temps, ainsi qu'à nos clients. Nous avons couvert la FAQ, et nos webhooks, ainsi que rédigé des guides pour certains des cas d'utilisation les plus populaires. La recherche est excellente et aide à naviguer dans notre API étendue, ce qui permet de gagner du temps pour trouver le point de terminaison dont vous avez besoin. Avis collecté par et hébergé sur G2.com.

C'est difficile de préciser quelque chose en particulier. Je dirais que le principal point de douleur serait l'éditeur de markdown. Ce n'est pas un énorme problème, mais c'est étrange de le voir dans une solution aussi moderne. Un autre inconvénient est qu'il n'y a pas de support intégré pour documenter les webhooks. Pour l'instant, nous devons utiliser des articles réguliers et c'est définitivement plus difficile à maintenir. Avis collecté par et hébergé sur G2.com.

Dès le moment où nous avons commencé à l'utiliser, nous avons été impressionnés par son interface conviviale et son intégration transparente avec divers outils. L'une des caractéristiques remarquables de readme est ses puissantes options de personnalisation. Nous avons pu adapter notre documentation pour correspondre à l'identité de notre marque, lui donnant un aspect professionnel et soigné qui résonne avec nos utilisateurs. De plus, les analyses et les insights de la plateforme ont fourni des données précieuses sur l'engagement des utilisateurs, nous permettant d'améliorer continuellement notre documentation et de répondre efficacement aux besoins de nos utilisateurs. Avis collecté par et hébergé sur G2.com.

C'est un peu déroutant de comprendre comment fonctionnent les plans, au début il n'est pas très clair si c'est par utilisateur, plan ou projet. Avis collecté par et hébergé sur G2.com.

ReadMe nous a permis en quelques jours de transférer notre documentation existante basée sur des fichiers vers un portail en ligne, consultable et magnifique. Le processus de création de nouveaux articles/guides est particulièrement simple. L'utilisation de markdown et de leurs blocs de construction signifiait que nous pouvions très facilement copier des documents existants et simplement ajouter des en-têtes/images comme bon nous semblait, et cela fonctionnait immédiatement. Pas besoin de s'embêter avec des formats ou des mises en page détaillés et l'ensemble du site est cohérent. Avis collecté par et hébergé sur G2.com.

Les pages de destination disponibles ne convenaient pas vraiment à nos besoins car nous avions un grand guide avec plusieurs catégories, nous avons donc dû créer une page HTML personnalisée, ce qui est devenu une tâche assez technique. Le produit final est bon, mais c'est quelque chose que seul un sous-ensemble de nos éditeurs/utilisateurs peut comprendre. Avis collecté par et hébergé sur G2.com.

La fonctionnalité de téléchargement OAS a optimisé et automatisé notre composant de mise à jour des spécifications API dans notre processus de publication et de déploiement ! Avis collecté par et hébergé sur G2.com.

Il n'y a pas grand-chose à détester, je suppose que la complexité de la gestion des identifiants API via l'authentification unique est le composant le plus difficile de ReadMe.com. Avis collecté par et hébergé sur G2.com.

Le support est merveilleux et j'apprécie vraiment la facilité avec laquelle on peut ajouter des membres à l'équipe. La mascotte est vraiment agréable et en général, cela fait le travail. Facile à mettre en œuvre. Avis collecté par et hébergé sur G2.com.

Manque d'outils de collaboration, pas d'outils de réutilisation de contenu, difficile de travailler avec des images et pas d'options pour les intégrer en ligne, etc. Ils améliorent constamment leurs outils de documentation API mais se concentrent très peu sur les besoins généraux des utilisateurs malgré de nombreuses recommandations au fil des ans. Certaines fonctionnalités sont réservées aux entreprises uniquement -- cela semble vraiment injuste qu'ils n'offrent pas l'option ad hoc. Les options de recherche globale et de téléchargement de PDF ne devraient pas être exclusives aux entreprises car le coût est tellement différent. Avis collecté par et hébergé sur G2.com.

Readme.io offre un processus de réflexion guidé sur la structuration de vos pages, vous donnant un moyen simple de créer votre documentation API avec une flexibilité illimitée grâce à l'éditeur de contenu. Les Guides et Recettes sont des éléments révolutionnaires pour les personnes utilisant votre documentation. Avis collecté par et hébergé sur G2.com.

Je ne peux vraiment penser à rien que je n'aime pas à propos de Readme.com - surtout comparé à d'autres plateformes que nous avons utilisées auparavant. Avis collecté par et hébergé sur G2.com.