NpgsqlConnection docs are missing most methods

[loop-evgeny]

https://www.npgsql.org/doc/api/Npgsql.NpgsqlConnection.html#methods shows only two methods now: Open() and OpenAsync(). NpgsqlConnection of course has a lot more methods than that!

[manandre]

Hello, thanks for reporting this documentation issue. We like to know that people actually read it 😉

I have managed to reproduce the issue locally and it took me quite some time to understand what is happening here.
We use docfx to generate the documentation and it does not yet support the latest version of the C# language (C# 9.0) that we actively use in the code of Npgsql since it was released last November.

DocFx processing stops on the NpgsqlConnection.cs file on line 309, just after the Open and OpenAsync methods.
I have "fixed" the file by removing any use of C#9 features and the documentation for the NpgsqlConnection class is correctly generated.

@roji How can we get this DocFx issue fixed quickly? Can we help?

[roji]

@manandre sorry for not commenting sooner, this slipped under my radar...

Unfortunately, docfx is... quite disappointing... AFAIK not even C# 8 is fully supported, and I tried pushing this both on the issue and internally, with little success. Unfortunately there isn't much we can do about it from our side, except keep signaling that this is important.

I'm going to close this now, but I encourage you guys to post on dotnet/docfx#6805 and on dotnet/docfx#4007, hopefully that will help...