La documentation F# se trouve désormais sur docs.microsoft.com

Cet article a été écrit par Jeff Sandquist, Directeur Général de la division Cloud + Enterprise.

Nous annonçons aujourd’hui la publication de notre documentation F# sur docs.microsoft.com. Il y a quelque temps, nous avons parlé de rendre la documentation F# open source, et dans un effort d’accélérer la croissance et les contributions, nous l’avons déplacée dans son emplacement définitif, où elle rejoint notre famille de documents portant sur le langage et les outils de la plateforme .NET.

Modifications générales

En termes de workflow, nous n’avons pas modifié l’approche : vous pouvez apporter votre contribution aujourd’hui comme vous le faisiez auparavant, simplement au sein d’un autre dépôt.

Parmi les choses les plus importantes, l’apparence de la documentation F# correspond désormais au style et aux thèmes de l’expérience docs.microsoft.com.

Voici ce que vous voyiez auparavant sur MSDN :

Old F# experience

Voici ce que vous verrez sur docs.microsoft.com :

New F# experience

La documentation F# est disponible dans le nœud Informations de référence sur le langage F# :

F# navigation

Comme pour toute autre documentation définie sur docs.microsoft.com, les articles F# peuvent désormais tirer parti de toutes les nouvelles fonctionnalités que nous exploitons sur le site, notamment la possibilité de passer d’un thème à l’autre, de partager facilement du contenu en un seul clic et d’utiliser le système de commentaires moderne intégré.

Aller de l’avant

Même si nous avons franchis la première étape de la migration de la documentation F# vers docs.microsoft.com, il reste du travail à effectuer. Comme vous l’avez peut-être remarqué, une grande partie ne s’y trouve pas encore : les informations de référence sur les API pour F#.

Nous travaillons activement à la création des outils nécessaires à l’automatisation de la production de documentations de référence pour F# de la même façon que l’avons fait pour .NET. Pour le moment, les documents sur les API pour F# se trouvent dans notre expérience MSDN.

Étant donné que la documentation de référence sur les API pour F# va subir une refonte importante, nous allons cesser dès maintenant d’accepter les contributions dans le dépôt de la documentation Visual F#. À la place, vous êtes invité à contribuer aux documents F# dans le dépôt de la documentation .NET.

Tenez-vous informé des prochaines mises à jour et n’hésitez pas à nous faire part de vos commentaires sur notre expérience.