{"action":"created","issue":{"url":"https://api.github.com/repos/Mashape/getkong.org/issues/12","labels_url":"https://api.github.com/repos/Mashape/getkong.org/issues/12/labels{/name}","comments_url":"https://api.github.com/repos/Mashape/getkong.org/issues/12/comments","events_url":"https://api.github.com/repos/Mashape/getkong.org/issues/12/events","html_url":"https://github.com/Mashape/getkong.org/issues/12","id":67028204,"number":12,"title":"docs.html layout should be versioned","user":{"login":"thibaultCha","id":1125431,"avatar_url":"https://avatars.githubusercontent.com/u/1125431?v=3","gravatar_id":"","url":"https://api.github.com/users/thibaultCha","html_url":"https://github.com/thibaultCha","followers_url":"https://api.github.com/users/thibaultCha/followers","following_url":"https://api.github.com/users/thibaultCha/following{/other_user}","gists_url":"https://api.github.com/users/thibaultCha/gists{/gist_id}","starred_url":"https://api.github.com/users/thibaultCha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thibaultCha/subscriptions","organizations_url":"https://api.github.com/users/thibaultCha/orgs","repos_url":"https://api.github.com/users/thibaultCha/repos","events_url":"https://api.github.com/users/thibaultCha/events{/privacy}","received_events_url":"https://api.github.com/users/thibaultCha/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":11,"created_at":"2015-04-08T01:43:23Z","updated_at":"2015-04-08T21:59:05Z","closed_at":null,"body":"[_layouts/docs.html](https://github.com/Mashape/getkong.org/blob/master/app/_layouts/docs.html) is what is on the left side of a documentation page. Not every version to document will have the same articles (in fact, the 2 versions we currently have already differ, resulting in a few 404s), and in the future there might be a lot more to it.\r\n\r\nTo dynamically generate it, we can either have a list of all articles in [kong_versions.yml](https://github.com/Mashape/getkong.org/blob/master/app/_data/kong_versions.yml), or we could dynamically generate that list via the [versions.rb](https://github.com/Mashape/getkong.org/blob/master/app/_jekyll_plugins/versions.rb) plugin. One is more flexible, the other is less to maintain.\r\n\r\nThen `docs.html` simply becomes:\r\n\r\n```html\r\n<aside class=\"page-navigation\">\r\n  {% for section in page.doc_link %}\r\n  <nav>\r\n    <h5>{{section.title}}</h5>\r\n    <ul>\r\n      {% for article in section.articles %}\r\n        <li href=\"/docs/{{page.kong_version}}/{{article.link}}\">{{article.name}}</li>\r\n      {% endfor %}      \r\n    </ul>\r\n  </nav>\r\n  {% endfor %}\r\n</aside>\r\n```\r\n\r\nWhich solution do we like better: YAML or automated?"},"comment":{"url":"https://api.github.com/repos/Mashape/getkong.org/issues/comments/91048634","html_url":"https://github.com/Mashape/getkong.org/issues/12#issuecomment-91048634","issue_url":"https://api.github.com/repos/Mashape/getkong.org/issues/12","id":91048634,"user":{"login":"thibaultCha","id":1125431,"avatar_url":"https://avatars.githubusercontent.com/u/1125431?v=3","gravatar_id":"","url":"https://api.github.com/users/thibaultCha","html_url":"https://github.com/thibaultCha","followers_url":"https://api.github.com/users/thibaultCha/followers","following_url":"https://api.github.com/users/thibaultCha/following{/other_user}","gists_url":"https://api.github.com/users/thibaultCha/gists{/gist_id}","starred_url":"https://api.github.com/users/thibaultCha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thibaultCha/subscriptions","organizations_url":"https://api.github.com/users/thibaultCha/orgs","repos_url":"https://api.github.com/users/thibaultCha/repos","events_url":"https://api.github.com/users/thibaultCha/events{/privacy}","received_events_url":"https://api.github.com/users/thibaultCha/received_events","type":"User","site_admin":false},"created_at":"2015-04-08T21:59:05Z","updated_at":"2015-04-08T21:59:05Z","body":"@ahmadnassri \r\n\r\n> if people want access to older docs, then they use git history.\r\n\r\nWait, are you saying we are currently versioning the docs for nothing?"}}