Discussion :

[BlakDrago]

Bonjour,

J'ai développé une API pour une application.

J'ai pris tout mon temps pour bien la commenté, ensuite j'ai généré un fichier CHM grâce à SandCastle.

J'aimerais savoir s'il est possible d'intégrer ce fichier d'aide dans VS2008 pour qu'il puisse y accéder directement en appuyant sur la touche F1.

Si vous avez quelques retours d'expérience à ce sujet ... cela m'aiderait.

---
BlakDrago

[tomlev]

En fait tu veux le "merger" (~fusionner) avec les fichiers d'aide de Visual Studio / MSDN ? Je pense que c'est possible, mais je sais pas trop comment... par contre je suis très intéressé par la réponse

[BlakDrago]

C'est exactement cela ...

Autres questions en rapport ... comment peut on faire pour garder les commentaires liés avec la dll.

Je m'explique, le but de l'api est de fournir un ensemble de dll.
Le problème est que, du coup, toutes la partie documentaire disparait (IntelliSense).

Je vous tiens au courant si je trouve des choses de mon coté.

---
BlakDrago

[tomlev]

Autres questions en rapport ... comment peut on faire pour garder les commentaires liés avec la dll.

Je m'explique, le but de l'api est de fournir un ensemble de dll.
Le problème est que, du coup, toutes la partie documentaire disparait (IntelliSense).

Il faut générer la documentation XML et la fournir avec les DLL. Enfin je crois...

[BlakDrago]

J'ai essayé mais cela n'a pas l'air de fonctionner.

J'ai mis en place un contournement, j'ai isolé les interfaces avec les commentaires dans un projet séparé que je fournit avec le SDK.

Ce n'est pas très grave pour le moment puisque l'on ne diffuse qu'en interne dans un premier temps mais ce ne fait pas très "pro".

Merci quand même et je continue de creuser le sujet ...

---
BlakDrago

[kileak]

J'ai essayé mais cela n'a pas l'air de fonctionner.

J'ai mis en place un contournement, j'ai isolé les interfaces avec les commentaires dans un projet séparé que je fournit avec le SDK.

Ce n'est pas très grave pour le moment puisque l'on ne diffuse qu'en interne dans un premier temps mais ce ne fait pas très "pro".

Merci quand même et je continue de creuser le sujet ...

---
BlakDrago

Salut,

as-tu réussi ?
je suis très intéressé par la réponse.

Je suis dans une équipe où l'on développe des outils qui s'intègre à VS 2005 (actuellement) & 2008 (très bientôt).
J'ai la doc en CHM grâce à cet excellent tuto : http://philippe.developpez.com/articles/SandCastle/

Mais maintenant, je souhaiterais l'intégrer pour que quand le développeur fait F1 sur une de nos classes, il ait l'aide qui s'affiche

Merci
à+

EDIT : j'ai finalement réussi.
Il faut suivre le tuto mais générer un fichier H2X (aide v2).
Puis dans VS2008, il faut créer un projet HELP INTEGRATION WIZARD.
Ca te crée en qq secondes une MSI et le tour est joué. Grandiose.