Existe-t-il un outil qui remplace javadoc par quelque chose qui soit plus une syntaxe de type Wiki que la syntaxe HTML de JavaDoc normal?Existe-t-il un remplacement javadoc qui utilise une syntaxe semblable à Wiki?
Un de mes problèmes est que je lis surtout JavaDoc sous forme de source. Même pour les bibliothèques externes, j'essaie d'avoir la source attachée afin que je puisse y accéder à partir de mon IDE, en vérifiant la documentation au-dessus du point d'entrée et si nécessaire le code ci-dessous.
L'autre problème est que les choses comme les listes et les exemples de code sont compliqués à écrire, surtout si votre IDE insiste pour mettre des étoiles sur chaque ligne. Ce que je voudrais voir est quelque chose qui utilise une sorte de syntaxe Wiki avec au moins les caractéristiques suivantes:
- listes
- blocs de code
- réticulation aux méthodes/classes
Il y a beaucoup d'autres choses qui seraient bien, mais je crois que ce sont les éléments essentiels.
Quelqu'un connaît-il un tel outil?
Les blocs de code ne sont pas trop mauvais avec '{@code}'. Je pense que {@link} 'fonctionne assez bien pour lier les membres et les types. –
pendant que vous pensez à l'affichage de type wiki, ce serait bien si vous pouviez aussi éditer le style wiki, et le replacer dans les commentaires. Je suppose que c'est demander un peu plus. – Carl