tds-fdw / tds_fdw

A PostgreSQL foreign data wrapper to connect to TDS databases (Sybase and Microsoft SQL Server)
Other
380 stars 102 forks source link

Documentation is broken on http://pgxn.org #44

Open ijmorlan opened 8 years ago

ijmorlan commented 8 years ago

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 commented 8 years ago

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 commented 8 years ago

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 commented 8 years ago

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 commented 8 years ago

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 commented 8 years ago

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:

https://github.com/pgxn/pgxn-api/issues/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 commented 8 years ago

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.