Documentation is broken on http://pgxn.org

[ijmorlan]

If I go here:

http://pgxn.org/dist/tds_fdw/

I get what looks like promising documentation with links for installing on various platforms and how to perform various actions, but the links are all 404 errors.

[ijmorlan]

I notice I can see the pages on github so I can read them now but it would still be nice if the pgxn.org site could be complete.

[juliogonzalez]

I can see the pages at http://pgxn.org/dist/tds_fdw/, section "Documentation". For example "Installing on Ubuntu" or "Installing on CentOS/RHEL".

Do you mean the links at the section README below?

[ijmorlan]

If I go to http://pgxn.org/dist/tds_fdw/ and click on "Installing on
Ubuntu" it takes me to:

http://pgxn.org/dist/tds_fdw/InstallUbuntu.md

... which is a "Not Found". Is this different from what you get?

[ijmorlan]

Ok, now I see what you are talking about. Yes, the links under "Documentation" are fine, but not the ones under "README". So it's unfortunate but I know just enough to guess that this might be harder to fix than one would assume. Also, the pages can actually be reached from the main page by using the links further up the page.

[GeoffMontee]

Hi @ijmorlan,

Sorry about that. The documentation is primarily written to look good on GitHub.

I've submitted a bug report for the PGXN site about this problem:

pgxn/pgxn-api#38

If it doesn't get fixed in PGXN, maybe I can change the relative links to absolute links that point directly to the pages on GitHub.

[ijmorlan]

Thanks for looking into this.

I should say I'm very pleased. Yesterday I installed tds_fdw on our development server and was able to connect to an MS SQL instance, set up some foreign tables, and query them with no real trouble. All I had to do was apt-get a couple of packages that weren't already there. I had expected to need to dump out text files and then import them into PostgreSQL but now it's looking like I won't have to. Thanks for your work on this.