Le plus gros problème que j'ai eu quand apprendre à programmer mes propres stratégies de trading dans JForex est de trouver où commencer à apprendre. Il y avait peu de documentation JForex disponible à l'époque et j'ai dû m'apprendre moi-même à travers des essais minutieux avec l'aide du support technique de Dukascopys. Les choses ont certainement changé pour le mieux car une communauté JForex commence à germer et la documentation pour elle est au moins suffisante pour obtenir quelqu'un a commencé. Ce post est le premier d'une série de guide rapide pour apprendre à apprendre la programmation JForex en mettant toutes ces ressources dans un tutoriel. JForex est un outil Java JForex n'est pas un langage de programmation. Il s'agit d'une interface de programmation d'application (API) à utiliser avec le langage de programmation Java standard. En tant que tel, la première étape pour apprendre à programmer dans JForex est d'apprendre Java. Heureusement, Java est l'un des langages de programmation les plus populaires. Donc therere beaucoup de ressources sur et en dehors du web pour apprendre la programmation Java. Quelques exemples de tutoriels en ligne gratuits sont: Les Didacticiels Java - Ceci est un tutoriel officiel du développeur de Java eux-mêmes. Hautement recommandé. Débutants Java Tutorial - Plus orienté pour les débutants absolu à la programmation. Si vous préférez un livre, je recommande Head First Java, 2nd Edition. J'ai brossé sur mon Java à partir de ce livre. Ne vous attardez pas trop sur Java, car il suffit de connaître les bases pour démarrer avec JForex. Il suffit de lire quelques chapitres pour comprendre la syntaxe Java, puis passer à autre chose. Vous pouvez toujours y revenir plus tard. Plonger dans JForex Le Wiki JForex est l'une des trois ressources essentielles pour les programmeurs JForex. Je vais me référer à certaines pages spécifiques du Wiki dans la plupart de cette série de messages. Si vous l'avez déjà fait, inscrivez-vous pour un compte DEMO à Dukascopy. Ensuite, lancez la plate-forme JForex et suivez les instructions sur la page wiki Utiliser dans JForex pour assembler votre première stratégie JForex Jusqu'à présent, si bon En ce moment, j'espère que vous pouvez comprendre le code source Java de base et savoir comment démarrer, compiler et exécuter un Stratégie JForex. Dans le prochain post de cette série d'apprentissage JForex, nous allons étudier l'anatomie d'une stratégie JForex. Concevoir des documents API grand La rédaction de la documentation est une de ces choses qui est redouté par de nombreux développeurs. Il faut beaucoup d'efforts et de temps pour bien faire. Et trop souvent, les gens prennent des raccourcis. C'est triste, parce que la documentation bien conçue est la clé pour obtenir les gens excités au sujet de votre projet, que ce soit son open source ou un produit axé sur le développeur. En fait, je prétends que la partie la plus importante de UX pour un produit développeur n'est pas la page d'accueil ou le processus d'inscription ou le téléchargement SDK. C'est la documentation API Qui se soucie si votre produit est la chose la plus puissante dans le monde si personne ne comprend comment l'utiliser. Si vous êtes un produit axé sur le développeur, la documentation est au cœur de l'expérience utilisateur que les points de terminaison eux-mêmes. Ive vu beaucoup trop de projets qui vous déchargent simplement sur une page GitHub avec un lisez-moi à deux liner. Les documents API les plus réussis sont soigneusement conçus avec amour. Ici à Parse, nous nous consacrons à cet art. Alors, quels éléments vont dans la fabrication de la documentation de l'API grande Documentation est une bête en couches Votre documentation ne devrait pas être une simple liste des points d'extrémité avec leurs paramètres. La documentation est un écosystème de contenu qui vise à enseigner aux utilisateurs comment interagir avec votre API. À tout le moins, vous devriez avoir ces composants: Référence: Voici la liste de toutes les fonctionnalités de excruciating detail. Cela inclut toutes les spécifications de type de données et de fonction. Vos développeurs avancés laisseront cela ouvert dans un onglet toute la journée. Guides: C'est quelque part entre la référence et les didacticiels. Il devrait être comme votre référence avec la prose qui explique comment utiliser votre API. Tutoriels: Ils enseignent à vos utilisateurs des choses spécifiques qu'ils peuvent faire avec votre API, et sont généralement étroitement concentré sur quelques morceaux de fonctionnalité. Points bonus si vous incluez un exemple de code de travail. À Parse, nous avons tous les trois de ces composants, et travaillent actuellement sur la mise en forme plus de tutoriels. Supprimer les abstractions avec des exemples Vous pouvez argumenter que votre API est une grande abstraction, et thats genre de point. Toutefois, lorsque vous enseignez les développeurs, essayez de supprimer autant d'abstractions que possible. Libéralement saupoudrer des exemples du monde réel dans toute votre documentation. Aucun développeur ne se plaindra jamais qu'il y ait trop d'exemples. Ils réduisent considérablement le temps pour les développeurs de comprendre votre produit. En fait, nous avons même code d'exemple sur notre page d'accueil. Ce n'est pas un secret que les développeurs détestent de cliquer. Ne diffusez pas votre documentation sur un million de pages différentes. Gardez des sujets connexes proches les uns des autres sur la même page. Étaient de grands fans de guides longue page unique qui permettent aux utilisateurs de voir la grande image avec la possibilité de zoomer facilement dans les détails avec une barre de navigation persistante. Cela a le grand effet secondaire que les utilisateurs peuvent rechercher tout le contenu avec une recherche dans le navigateur de la page. Un bon exemple de cela est la documentation Backbone. js. Qui a tout à portée de main. Inclure un Quickstart doux La partie la plus difficile de l'adoption d'une nouvelle API est au début, où la courbe d'apprentissage est raide et le développeur est exposé à de nouvelles idées compliquées. La solution est d'introduire l'API avec un guide de démarrage rapide. L'objectif du quickstart est de marcher l'utilisateur à travers les étapes minimales nécessaires pour faire la plus petite chose possible dans votre API. Rien de plus. Une fois qu'un utilisateur a fait cela, theyre prêt à passer à des concepts plus avancés. Par exemple, notre guide de démarrage rapide permet à l'utilisateur de télécharger nos SDK et d'enregistrer un objet sur notre plate-forme. Nous avons même un bouton qui permet aux utilisateurs de tester si theyve fait correctement. Cela leur donne la confiance nécessaire pour aller de l'avant et apprendre le reste de notre plate-forme. Utiliser des langues multiples Nous vivons dans un monde polyglotte. Le cas échéant, essayez de répertorier des exemples de langues multiples pris en charge par votre API, probablement via les bibliothèques clientes. Apprendre une nouvelle API est assez difficile sans avoir à analyser des langages inconnus. MailGuns API fait un excellent travail en laissant les développeurs choisir entre curl, Ruby, Python, Java, C et PHP pour les exemples dans un menu global. Vous ne pouvez jamais sur-communiquer des cas de bordure La chose la plus mauvaise est de développer avec une API seulement pour découvrir un état d'erreur qui n'est pas documenté. Dans des situations comme celle-ci, il peut ne pas être clair si l'erreur est dans votre code ou dans votre compréhension de l'API. Votre référence doit inclure tous les cas de bordure et chaque hypothèse qui est faite, implicitement ou explicitement. Passer quelques minutes à faire cela peut sauver des heures de temps collectif de vos utilisateurs. À la fin de la journée, les développeurs veulent voir la grande image. Et la meilleure façon de montrer que c'est avec des exemples d'applications. Je trouve que le code d'application est la meilleure façon de communiquer comment tout dans votre API liens ensemble et comment il s'intègre avec d'autres systèmes. Un bon exemple de ceci est l'exemple de code dans Apples iOS Developer Library. Qui a une sélection exhaustive d'exemples d'applications iOS organisées par thème. Lire la documentation d'API n'est pas exactement un tour de montagnes russes passionnant. Mais, vous pouvez au moins ajouter un peu de personnalité et de plaisir dans votre écriture. Surprenez votre lecteur avec des exemples drôles et des noms de variables autres que foo. Cela les empêchera au moins de s'endormir. Le chemin vers un cœur de développeurs est une excellente documentation. Et, la grande documentation exige beaucoup d'investissement. Mais, cet investissement en vaut la peine, et est tout aussi important pour un produit développeur que l'API elle-même. L'autre moitié de cela est la conception d'une grande API en premier lieu. Mais, ce sera le sujet d'un autre poste. Psst: Si vous aimez les API bien conçues et les gens d'enseignement à leur sujet, ont été l'embauche d'un évangéliste développeur à Parse. Publié le 11 janvier 2012
No comments:
Post a Comment