Hi all,
Is there a good tool I can use to generate MS Word documentation of a web
service?
I find typing up documentation manually a hassle (i.e. need to do all the
dependencies manually).
Can MS doc be exported to Word?
I'm using VS.NET 2008 and .NET 3.5.
Thanks.
--
spamhoneypot@rogers.com (Do not e-mail)
If you use XML Comments, you'll have the ability to have your documentation
in an .xml file with no hassle. From there, you can apply your own
stylesheet to it to give it the look you want or you can use a tool like
Microsoft's "Sandcastle" to generate the documentation files you need.
-Scott
"Spam Catcher"
news:Xns9A75AE3A32D33usenethoneypotrogers@127.0.0.1...
> Hi all,
>
> Is there a good tool I can use to generate MS Word documentation of a web
> service?
>
> I find typing up documentation manually a hassle (i.e. need to do all the
> dependencies manually).
>
> Can MS doc be exported to Word?
>
> I'm using VS.NET 2008 and .NET 3.5.
>
> Thanks.
>
> --
> spamhoneypot@rogers.com (Do not e-mail)
"Scott M."
news:esAi2UdlIHA.4480@TK2MSFTNGP03.phx.gbl:
> If you use XML Comments, you'll have the ability to have your
> documentation in an .xml file with no hassle. From there, you can
> apply your own stylesheet to it to give it the look you want or you
> can use a tool like Microsoft's "Sandcastle" to generate the
> documentation files you need.
Seems like WCF Web Services no longer support XML Documentation like ASMX
did? :-(
--
spamhoneypot@rogers.com (Do not e-mail)
I haven't tried it, but the ability to use XML comments isn't based on the
project type. It's part of the language compiler and should be available no
matter what type of project you are building.
"Spam Catcher"
news:Xns9A76804694C52usenethoneypotrogers@127.0.0.1...
> "Scott M."
> news:esAi2UdlIHA.4480@TK2MSFTNGP03.phx.gbl:
>
>> If you use XML Comments, you'll have the ability to have your
>> documentation in an .xml file with no hassle. From there, you can
>> apply your own stylesheet to it to give it the look you want or you
>> can use a tool like Microsoft's "Sandcastle" to generate the
>> documentation files you need.
>
> Seems like WCF Web Services no longer support XML Documentation like ASMX
> did? :-(
>
>
> --
> spamhoneypot@rogers.com (Do not e-mail)
You can try our VSdocman (http://www.helixoft.com/vsdocman/overview.html). It
will directly generate RTF output from your WCF Web Services project.
--
Peter Macej
Helixoft - http://www.helixoft.com
VSdocman - Commenter and generator of class documentation for C#, VB
..NET and ASP .NET code
"Scott M."
news:eYeQK1rlIHA.3876@TK2MSFTNGP06.phx.gbl:
> I haven't tried it, but the ability to use XML comments isn't based on
> the project type. It's part of the language compiler and should be
> available no matter what type of project you are building.
Yes, true - but depending on how you build the service in WCF, the
documentation is more suited for internal use rather than external use.
Basically the way .NET documents WCF is only useful to an internal
developer (i.e. person managing the code).
--
spamhoneypot@rogers.com (Do not e-mail)
=?Utf-8?B?UGV0ZXIgTWFjZWo=?=
wrote in news:7AB9C64D-897D-4AC9-A9E7-6D7268AC8C1C@microsoft.com:
> You can try our VSdocman
> (http://www.helixoft.com/vsdocman/overview.html). It will directly
> generate RTF output from your WCF Web Services project.
This is the sort of utility I'm looking for.
I'm using MessageContracts in my WCF project - will VSDocMan handle this
scenario correctly?
--
spamhoneypot@rogers.com (Do not e-mail)
> I'm using MessageContracts in my WCF project - will VSDocMan handle this
> scenario correctly?
Yes, it should work fine. I have tried simple example that uses
MessageContracts and generated documentation looked good to me. But I'm not
an expert in such projects. So if you have further questions I'll be glad to
answer you by email. You can reach me directly from Contact form on our site.
Kind regards
--
Peter Macej
Helixoft - http://www.helixoft.com
VSdocman - Commenter and generator of class documentation for C#, VB
..NET and ASP .NET code