Ho provato Sandcastle con le patch incluse con l'installazione GUI guidata, ma a meno che non stia facendo qualcosa di molto sbagliato è fondamentalmente inadatto per la documentazione del codice F # (anche se funzionerebbe davvero bene per C#). Forse funziona per gli altri, nel qual caso sarei molto grato per un breve esempio completo da cui potrei partire. Grazie molto.Qual è il modo migliore per documentare il codice f #?
Sono a conoscenza di Sandcastle doesn't output everything from a F# assembly, ma il progetto a cui fa riferimento non è ancora pronto per la stampa in prima serata.
Ci deve essere sicuramente qualcosa che funzioni in modo affidabile ed è "abbastanza buono"? Molte grazie per qualsiasi suggerimento.
Modifica: Molte grazie a tutti coloro che hanno risposto. La risposta di Brian è stata la più vicina a ciò che volevo, quindi lo accetterò. Tuttavia, il risultato è che non sembra esserci una soluzione che sia adatta a F # e che funzioni in modo affidabile. Continuerò con commenti testuali per ora.
Mi aspetto che FsHtmlDoc.exe inizi a funzionare ad un certo punto. Mentre non posso escludere che funzioni già e io non l'ho usato correttamente, googling suggerisce che non sono il solo a scoprire che non è ancora perfetto.
Molte grazie. Sfortunatamente, mi sembra di imbattersi in http://fsharppowerpack.codeplex.com/workitem/6375# (anche se potrebbe facilmente essere che sia io sia chiunque abbia segnalato che il bug ha fatto qualcosa di sbagliato) – user1002059