transportapi / api-console

A Web Component for an interactive REST console based on RAML files
Other
0 stars 0 forks source link

doc page per resource versus javascript heavy docs #8

Open harry-wood opened 8 years ago

harry-wood commented 8 years ago

Following on from https://github.com/transportapi/api-console/issues/7 I personally have a preference, and I believe search engines also have a preference, for a more old-school web site composed of several pages loaded from different URLs, versus the newfangled javascript-heavy everything-on-one-page-with-broken-scrolling approach followed by the API console.

Probably the only fix to this issue would be to use something different :-( But there are some other RAML-powered documentation tools which run server-side generating a page per resource. Could be worth looking into.