Méthode recommandée pour ajouter de l'aide à une grande solution Visual Studio

Question

Je travaille sur une solution de grande taille contenant des dizaines de projets. J'approche le point où je devrai ajouter de l'aide. Je m'attends à utiliser RoboHelp pour créer le (s) fichier (s) d'aide html, mais c'est la première fois dans .NET, donc je cherche des conseils sur la façon de procéder. Je sais comment créer un fichier d'aide et je n'ai besoin d'aucun conseil à ce sujet. J'ai besoin d'aide pour la meilleure façon d'intégrer l'aide dans ma solution. Est-ce que je crée plusieurs fichiers d'aide, disons un fichier d'aide distinct pour chaque projet, ou est-ce que je crée un seul fichier d'aide pour la solution complète et puis-je ajouter un dossier d'aide pour l'organisation?

Answer 1

Posez-vous des questions: avez-vous des dizaines de DLL compilées en un fichier EXE?> Utilisez un fichier d'aide.

Avez-vous des dizaines de fichiers EXE? Et ces fichiers EXE forment-ils un système d'application pour un seul utilisateur assis devant lui -> un seul fichier d'aide le fera.

Ou sont ces fichiers EXE pour plusieurs groupes d'utilisateurs avec différents types de cas d'utilisation? (-> alors vous pourriez avoir besoin de plus d'un fichier d'aide).

Un autre point peut être: voulez-vous fournir à vos utilisateurs un manuel imprimable (ou un fichier PDF), généré à partir de la même source que vos fichiers d'aide? Si oui, considérez le nombre de manuels d'utilisation dont vous avez besoin (le manuel d'installation ne compte pas). Le nombre de manuels d'utilisateur différents doit être le même que le nombre de fichiers d'aide.