Split docs into pages as opposed to one long page about openwhisk-website

[mrutkows]

@Juice10 actually, the long-term plan is not to "split" the page but make sections collapsible and look to add a documentation (road)map.

[Juice10]

@mrutkows would that fix the SEO and usability concerns?

[Juice10]

The downside with waiting with this is that when we do decided to split the docs into different pages, redirecting people is going to have to happen on the client side and which will mean that it won't get picked up by search engines that easily. The longer we wait the more comprehensive our redirects will have to get on the client side, because more people will start linking to our pages with the page anchors.

Examples of redirects I foresee needing to be put in place if we continue down the 'one long page' path for much longer.
http://openwhisk.org/documentation.html#wsk-cli-install => http://openwhisk.org/docs/wsk-cli-install
http://openwhisk.org/documentation.html#deploy_docker_compose => http://openwhisk.org/docs/deploy-docker-compose

Now the site is still fresh and young and the inbound (deep)links are still somewhat limited we have the chance to not get ourselves into too much technical (redirect) debt.