 Alors, j'ai dit que vous devez utiliser beaucoup de vos imaginations et quand je dis que c'est juste quoi, essayer d'avoir ça dans votre cerveau ou quelque chose, donc ce sera un résidus à la documentation, vous pouvez l'enjouer. Donc, premièrement, pourquoi suis-je, donc je suis le leader du résidus, depuis récemment. Je suis aussi partie du team de documentation, le team de documentation, le team de documentation et le team de dev-tools. Donc vous voyez quelque sorte de pattern, je pense, je pense. Donc, j'ai commencé à travailler en résidus en 2015, je pense. Donc depuis, il y a eu beaucoup de choses qui ont apporté. Et ma main focus currently est le résidus et la documentation globale. Donc, j'ai besoin de travailler sur Docs.RS et un peu d'autre chose qui est relative. Donc, j'ai essayé de montrer comment nous pouvons provider la documentation et la plupart des choses que nous avons, qui sont plutôt bonnes maintenant. Donc, premièrement, ce que est le résidus ? Donc, le résidus est un tool qui a été utilisé à l'extérieur, le compiler et le cargo, qui est utilisé pour générer la documentation, comme vous pouvez l'imaginer. Vous pouvez faire un peu plus, mais on reviendra à voir ça plus tard. Je pense que c'est le plus... Ah oui, oui, oui, oui. Donc, c'est le résidus. Donc, le résidus, oui, comme vous pouvez, vous devez l'imaginer, mais vous pouvez utiliser le résidus multiplement, comme directement sur le résidus et vous le donnez un file et ça fonctionne. Mais quand vous commencez à avoir des dépendances, c'est un peu tricot et la ligne de commande est en train d'être assez longue. Donc, bienvenue à la fin de l'arrivée. C'est bricot, bricot. Donc, maintenant, vous pouvez arrêter de l'avoir dans votre mind. Juste lire. Donc, comme je l'ai dit, vous pouvez l'utiliser directement sur la ligne de commande ou vous pouvez utiliser cargo doc, ce qui fait que les choses sont beaucoup plus simples. Donc, vous n'avez pas à penser à toutes les dépendances et tout. Vous avez juste cargo doc et tout est fait dans le background. Et c'est assez beau. Et vous pouvez même avoir votre browser ouvert et aller sur votre page, sur votre documentation. Juste ajouter dash, dash, ouvert et c'est assez bien. C'est très convenu. Donc, bienvenue à la fin. C'est quelque chose que nous avons utilisé pour ceux qui ne le connaissent pas. Nous avons des indexes d'erreur et vous pouvez, bien, nous avons besoin d'avoir quelque chose pour générer la page Magdon. Donc, le REST doc peut réunir et convertir le Magdon à 2 HTML. Donc, si à un moment vous avez besoin de convertir, ça marche très bien. Donc, documenter. Nous avons essayé de focusser sur le documentation faits comme beaucoup dans le code possible, parce que dans les langues le documentation et le code sont généralement expliqués et vous avez besoin de relier sur deux outils qui ne sont pas officiels. En REST, nous avons eu l'occasion d'avoir des gens qui sont venus très rapidement, qui ont justifié la compagnie AST et converti-la dans l'HTML. Donc, pour faire ça, vous pouvez avoir les documents comme ça. Donc, dash, dash, non, pas dash, bang, bon, exactement, exclamation mark, sorry, c'est pour documenter le module. Et si vous avez juste mis dash, dash, dash, c'est pour documenter le suivant item. Donc, ici, il sera la fonction et le premier sera pour le module et le consignor d'air, comme nous sommes sur le top de la velle, ce sera le créateur. Et c'est, en fait, le sugar syntactic. Donc, normalement, vous devez faire ceci, ce qui est le même, mais un peu moins sexy, on dirait comme ça. Mais si vous voulez faire des trucs de tric, avec les documents, vous devez l'utiliser. Les gens ne savent pas de ça, et c'est bien. Donc, oui, en fait, REST Doc est un très bon tool pour découvrir des choses qui sont implémentées sur vos types, sur vos dépendances. Ce n'est pas seulement les implantations blanquettes. Donc, quand vous implementez un trait sur un type générique. Donc, par exemple, vous implementez un trait sur chaque type implémenté en débug. Puis, évidemment, tous les types, vous devez déclarer que l'implément de débug va avoir ça, mais si vous connaissez que dans vos dépendances, vous avez un qui fait ça, vous n'aurez pas de pouvoir le voir. Et REST Doc s'entend et donne ces implantations blanquettes. C'était, en fait, je l'ai fait très récemment, parce qu'on avait à targeter directement l'interne compiler virtual machine, c'était un bon temps. Et ça marche très bien maintenant. Et nous avons aussi le trait auto. Donc, par exemple, sand and sink. Il y a quelques plus, mais on va rester sur ces deux. Donc, si vous avez des types primitives, il y aura à peu près de cinq ou cinq. L'une d'eux sera implémentée et vous le verrez directement dans la documentation. Vous n'avez pas besoin de passer par votre code et juste de tester. Vous pouvez le voir, ce qui est, en fait, très convaincu. Et ça vous permet de vous protéger le temps. Donc, de suite, pour vous aider sur votre documentation, REST Doc a ajouté le même système lint que REST a. Donc, maintenant, vous pouvez utiliser directement lintes dans REST Doc. Et par défaut, ils sont juste warnés. Mais vous pouvez juste dénoncer tout. En cas que vous vouliez provider un framework, c'est, en fait, très utile. Et l'une d'eux est, en cas que vous avez un item, module, fonction, instructions, tout. C'est la documentation que vous avez faite. Et l'une d'eux est, en cas que vous avez un code exemple dans votre document, ce qui est quelque chose que j'ai essayé de l'enforcer sur toute la documentation. Donc, ce n'est pas si bon. On le verra plus tard. Oui, donc maintenant, sur la documentation. Donc, en fait, quand vous prouvez et write un code exemple dans votre documentation, ils sont testés quand vous vouliez un REST Doc. Donc, par exemple, ici, si vous vouliez un test de cargo, cargo, encore, tout le code exemple à l'intérieur sera rendu. Et ici, vous aurez votre code en passant en cas que vous l'avez rendu. Mais depuis que vous avez un tag sur votre code exemple, ce n'est pas seulement testé comme compilé. Mais c'est testé. Merci à ça, vous pouvez en fait avoir beaucoup moins de, comment dire, un test API pour être sûr que tout est à la date. Et en même temps, vous pouvez en faire des documentations. C'est un grand temps. Vous avez eu beaucoup de temps, encore une fois. C'est très convaincant. Et c'est quelque chose que nous avons travaillé beaucoup,最近. Vous avez beaucoup plus de recommandations et des tags que vous pouvez utiliser sur le code exemple. Donc, je vais revenir à ça un peu plus tard. Donc, comme je l'ai dit, quand vous vouliez faire un REST Doc test, si vous vouliez faire spécifiquement un REST Doc test, vous vouliez juste un test de cargo, un REST Doc, un REST Doc test. Si vous vouliez faire un test de cargo, ce sera aussi un test de cargo. Tout est marqué par Shibang, Paran et un test. Donc, comme je l'ai dit, vous avez plus de tags. Donc, en cas que vous avez, vous êtes maintenant écrit le code, votre code, votre API n'est pas stabil. Vous pouvez utiliser Hellow Fail, ce qui vous permet de fail, évidemment. Si vous voulez, si vous avez écrit un proc-micro, ou un micro, vous pouvez utiliser CompiFail pour vérifier que l'un des codes est spécifiquement fail, ce qui, à un moment, est très convenu, en cas que vous vouliez provider des bonnes erreurs pour les utilisateurs. Et bien, si vous vouliez faire un REST EDITION, nous avons eu deux, nous avons aussi voulés un REST. Donc, vous pouvez spécifier, je ne veux pas que vous soutiez, je ne veux pas que vous soient testés dans les dernières éditions, vous pouvez le mettre dans le 2015. C'est bien. Vous pouvez ignorer, parce que vous ne voulez pas être testés ou quelque chose, vous vouliez juste avoir ça. Et pour être note, c'est que CompiFail et Ignore sont marqués dans la documentation comme ça. Donc, CompiFail est marquée avec une grande rondeur, comme c'est supposé de fail. Et Ignore est juste comme, non, c'est pas REST, c'est pas REST. Donc, NoREST n'est pas REST, mais c'est CompiFail. C'est très convenu quand vous avez I.O., par exemple. Le REST n'est pas un mandatariateur, mais c'est toujours sympa de spécifier que c'est un bloc de REST. Mais comme je l'ai dit, par défaut, si pas spécifié, c'est REST. Donc, c'est pas très utile en soi-même. Et le coup de panique est, en fait, en cas que vous vouliez, vous vouliez le panique. Si vous ne paniquez, c'est un fail. Et tout d'autre, comme pour exemple, si vous avez un bloc avec un texte ou tout, il sera interprété comme une autre string de langage. Donc, si votre langage s'appelle le panique de chou, il y aura un problème. Parfois de ça, il sera bien. Mais ce n'est pas tout. Donc, nous j'ai travaillé beaucoup en faisant le REST qui travaille avec pas de JavaScript. Donc, si vous n'avez pas de JavaScript, vous n'aurez pas pas d'application très bonne. Mais vous avez tout. Tout sera disponible. Ça va fonctionner. Le REST. Donc, vous pouvez rassembler par le documentage restant de votre crée. Il n'a pas besoin d'une connexion internet. Ça fonctionne localement. C'est un JavaScript. Le côté dernier est qu'on a une grande indexe de search. Mais au moins ça fonctionne sans internet. Donc, si vous n'avez pas de JavaScript, vous n'avez pas d'application. Ça ne fonctionne pas, évidemment. Comme je l'ai dit, vous n'avez pas besoin d'une connexion internet. C'est quelque chose que j'ai très fortement renforcé. Parce que beaucoup de gens voudraient avoir, par exemple, une source extérieure avec les pro et les cons. Tout ça. Et quelques plus JavaScript plus grandes comme Amber frameworks. C'est un débat en arrivant. Vous avez un viewer source code. Et je vais revenir un peu sur ceci plus tard. Pour maintenant, c'est assez simple. Je commence à le faire plus bon et user-friendly. Et le gars ici est principalement pour les gens d'avoir directement un mapping sur la fonction UCI. Vous pouvez cliquer sur SRC. Vous allez aller à la définition et vous pouvez voir comment c'est vraiment implémenté. Maintenant, vous avez aussi un whole file Cree et tout. Donc vous pouvez passer les files et tout. Donc ce que j'ai vu sur le viewer source code c'est que currently, c'est très simple. Vous avez juste un syntaxe de highlighting. Et c'est sympa pour être par exemple quand vous avez un type pour pouvoir voir où c'est utilisé et où c'est défini. Il reste à faire et nous avons beaucoup de débats sur comment il faut faire et beaucoup de choses ont à être encore déterminées. On n'est pas trop sûrs encore comment ça va être utilisé. Mais beaucoup de choses vont là dans pas si longs. Et donc je dirais que j'ai vu les secteurs aussi. Les secteurs vous demandent d'avoir plus précise l'expérience par exemple des gens ont demandé pour le premier élément quand vous avez un start avec seulement un résultat ils voulaient aller c'est-à-dire aller quelque chose. Et si vous avez seulement un résultat ils vont aller à ce résultat sans aucune page de search sur le rondeur sur l'édition. Encore, ils ont eu un temps comme ça. Je ne suis pas pas sûrs sur quelque chose. Beaucoup de gens ont complétenu que les types de définition quand c'est disponible ont été collabés par défauts. Nous l'avons maintenant à choisir exactement les types qu'ils veulent être collabés ou pas. Et beaucoup de ces settings sont là. Et surtout, les settings qui apparaissent quand nous avons une grande débat avec pas so much des gens qui ont pris l'un de l'autre précisément quand nous ne savons pas vraiment si les gens voulaient de défauts ou pas. Donc, nous voulons faire un nouvel setting et c'est plutôt ça. C'est quelque chose que j'avais poussé pour un long temps, les sims ont été mises il y a quelques ans et maintenant vous pouvez ajouter votre propre sim qui est assez convenant. Et vous avez quelques règles pour suivre comme vous devez impliquer toutes les règles que vous avez. Sinon, vous n'aurez pas pour ajouter et ce sera juste une erreur à la compagnie. Mais vous pouvez ajouter votre propre sim. C'est très simple et à la plupart de vos features à un moment je devais faire la documentation sur comment faire ça. C'est customisable. En fait, vous pouvez très bien changer tout par la ligne de commande pour ajouter votre propre file sur CSS, JavaScript, HTML même si vous voulez. Et je ne sais pas si les gens connaissent les pannes créées sur Dox.terrest mais à un moment vous devriez prendre des recettes intéressantes. C'est comme ça. Et le but de ce c'était à l'aujourd'hui pour pouvoir avoir plus de expériences spécifiques. Tout ce que les utilisateurs veulent par exemple si vous voulez votre documentation pour voir plus comme un livre que une documentation. Nous n'avons pas vu beaucoup de gens en fait l'utiliser d'exemple d'un standard libraux et de ce que je fais moi-même. Donc à un moment là je pense ce que j'aime là c'est une fois de documentation qui est un peu ironique. Donc très rapidement ce qui est venu donc comme je l'ai dit plus interactive source code viewer l'automatique génération basé sur le type name pour pour l'instant vous avez juste mis une string et ce sera le lien pour la string vous n'avez pas à le faire vous-même plus plus d'outre formats supportés donc ça vient de des gens qui comment la page devrait sembler et pour fixer cette issue je j'ai proposé pour générer Jason ainsi que l'HTML donc c'est en train et c'est en train de prendre beaucoup de temps nous avons maintenant une condition documentation donc vous pouvez juste dire si je suis sur cette plateforme je ne veux pas cette chose être un documentaire pour une raison et maintenant le problème est en cargo et je dois aller c'est pour maintenant l'on l'utilise dans la éstudie libraire donc pour exemple si vous regardez pour le un par un vous avez la référence page qui sera réterne dans le sort oui donc vous voyez par un