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.

[ Full content available at: 
https://github.com/apache/incubator-openwhisk-website/issues/320 ]
This message was relayed via gitbox.apache.org for [email protected]

Reply via email to