VB.NET, Web Services and Documentation

jonasbn on 2003-06-30T21:04:45

VB.NET is a poor language lacking POD.

But since .NET Web Services can have a description tag, I can put HTML links in these and point to HTML pages, it requires a lot of work to write docs in HTML, but at least it is better than nothing - and you could say that the docs follow the code...


HTML? Why?

tagg on 2003-07-01T12:37:10

Remember, you can still write your docs in POD, and use pod2html(1) ...

Re:HTML? Why?

jonasbn on 2003-07-01T13:45:31

Yes, I am thinking about writing a POD parser for VB.NET so I will end up with autogenerated HTML :)

Re:HTML? Why?

tagg on 2003-07-01T14:30:14

Isn't it 'just' a question of embedding POD in the .vb files, as VB comments? That way, the VB compiler will ignore it, and pod2html will already ignore anything not in =pod sections...

Re:HTML? Why?

jonasbn on 2003-07-01T14:43:21

Exactly :)

The hard part is getting people to write docs, that is a language and platform independent problem, even though Perl programmers seem to be easier to convince, perhaps this is due to the obfuscative nature of Perl?