I've written a library that makes use of features from another library (Oracle's ODP.NET). I'm trying to make types from ODP.NET, such as OracleConnection, hyperlink back to the Oracle documentation that is also installed.
I've been up and down and all around, beaten my head to a bloody pulp, and I can't get this to work. Can't figure out what I'm missing.
Things that I think are necessary:
- Created another SHFB project that pulls in the ODP.NET DLL.
- Using Additional Reference Links plug-in to pull in that other project. This gets things like "OracleConnection" to render as a clickable link rather than plain text.
- I also added the ODP.NET DLL as a Reference in the Project Explorer. This didn't seem to make any difference to anything.
- Used Help Integration Wizard to build an installer to install my documentation, plugged in below the ms-help://MS.VSCC.V80/MS.VSIPCC.V80 namespace.
That represents two days work, right there. But still no joy. Clicking on OracleConnection brings me to an "Information Not Found" error.
If I view the source of my help page, it shows the OracleConnection link as <mshelp:link keywords="T:Oracle.DataAccess.Client.OracleConnection" tabindex="0">. This is substantially similar to how .NET Framework links look:
<mshelp:link keywords="T:System.String" tabindex="0">
But the "string" link works, and the "OracleConnection" link doesn't.
Oracle's documentation is also installed under MS.VSCC.V80/MS.VSIPCC.V80, just like mine.
What am I missing? Could it be something wrong with the Oracle documentation itself?