{"action":"created","issue":{"url":"https://api.github.com/repos/opentracing/opentracing.github.io/issues/121","repository_url":"https://api.github.com/repos/opentracing/opentracing.github.io","labels_url":"https://api.github.com/repos/opentracing/opentracing.github.io/issues/121/labels{/name}","comments_url":"https://api.github.com/repos/opentracing/opentracing.github.io/issues/121/comments","events_url":"https://api.github.com/repos/opentracing/opentracing.github.io/issues/121/events","html_url":"https://github.com/opentracing/opentracing.github.io/issues/121","id":181910922,"number":121,"title":"RFC: New Opentracing Site","user":{"login":"pritianka","id":2413464,"avatar_url":"https://avatars.githubusercontent.com/u/2413464?v=3","gravatar_id":"","url":"https://api.github.com/users/pritianka","html_url":"https://github.com/pritianka","followers_url":"https://api.github.com/users/pritianka/followers","following_url":"https://api.github.com/users/pritianka/following{/other_user}","gists_url":"https://api.github.com/users/pritianka/gists{/gist_id}","starred_url":"https://api.github.com/users/pritianka/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pritianka/subscriptions","organizations_url":"https://api.github.com/users/pritianka/orgs","repos_url":"https://api.github.com/users/pritianka/repos","events_url":"https://api.github.com/users/pritianka/events{/privacy}","received_events_url":"https://api.github.com/users/pritianka/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":10,"created_at":"2016-10-09T20:55:03Z","updated_at":"2016-10-11T23:53:48Z","closed_at":"2016-10-11T23:53:48Z","body":"## Status\r\n\r\nRequest-for-comments about the latest iteration of the OpenTracing website demoed at the OpenTracing quarterly update call. It is available at - https://reimertz.github.io/opentracing.io/ \r\nI am putting an issue here because @reimertz has the code on a separate repo right now (not a fork) and will push the code soon. I wanted to give everyone more time to review since we would like to release the new site by Tuesday, Oct 11, 2016.\r\n\r\n## Problem\r\n\r\nThe current OpenTracing website contains a lot of information but it is written in an academic paper format. It is hard to get at-a-glance value of the project and know what to do next. Furthermore, there is inadequate documentation guiding people along distributed tracing. \r\n\r\n## Solution\r\n\r\n### Scope\r\nFor this v1 release, we should have a homepage that conveys the legitimacy of the project. The documentation needs to guide a visitor through instrumenting a large system (application or OSS project). This is meant to be a first release and we do not expect the documentation to cover every single edge case. We plan to add more documentation and other pages in future releases. \r\n\r\n### Current solution \r\nWe’ve built an aesthetically appealing version of OpenTracing. The site has a new home page and GitBooks based documentation. We’ve also added documentation that guides visitors on tracing best practices. The new docs added (already reviewed by the community) are - \r\n\r\n[Overview](https://reimertz.github.io/opentracing.io/documentation/pages/overview.html)\r\n\r\n[How to instrument large systems](https://reimertz.github.io/opentracing.io/documentation/pages/instrumenting-large-systems.html)\r\n\r\n[How to instrument a framework](https://reimertz.github.io/opentracing.io/documentation/pages/instrumenting-frameworks.html)\r\n\r\n## Corrections in progress\r\n\r\nPlease keep in mind that we are already working on the following issues with the current iteration  - \r\n1. Unifying the font of Docs and GitHub dropdown is different from the rest of the site. \r\n\r\n2. Darkening the font for the \"App dev\", \"Framework dev\" and \"Why opentracing' which is so light, it feels like it's not fully colored letters.\r\n\r\n3. Putting \"join the mailing\" somewhere up top in the page as well as the footer so that people can sign up.\r\n\r\n4. Footer - \r\n\r\na. Only showing the links to the top level docs instead of all of them. Overview, Quickstart, API, Instrumentation, Concepts and terminology. We can also put in Instrumenting a framework.\r\n\r\nb. The \"Connect with OpenTracing\" will have the underline like the rest of the headings.\r\n\r\nc. Removing the \"News/Events\" and \"FAQ\" for now.\r\n\r\nd. Putting the following under Resources and removing the rest - About, Blog, Supported Tracers\r\n\r\ne. Putting the following under Ecosystem and removing the rest - GitHub, Mailing list, Twitter, Blog\r\n\r\n## Proposed next steps\r\n\r\nPlease review this at your convenience. We would like to release the new site by Tuesday, October 11th. So it would be helpful to have comments in before that.\r\n\r\nThanks very much!\r\n\r\n_cc @bensigelman @reimertz_\r\n"},"comment":{"url":"https://api.github.com/repos/opentracing/opentracing.github.io/issues/comments/253080795","html_url":"https://github.com/opentracing/opentracing.github.io/issues/121#issuecomment-253080795","issue_url":"https://api.github.com/repos/opentracing/opentracing.github.io/issues/121","id":253080795,"user":{"login":"bensigelman","id":2251553,"avatar_url":"https://avatars.githubusercontent.com/u/2251553?v=3","gravatar_id":"","url":"https://api.github.com/users/bensigelman","html_url":"https://github.com/bensigelman","followers_url":"https://api.github.com/users/bensigelman/followers","following_url":"https://api.github.com/users/bensigelman/following{/other_user}","gists_url":"https://api.github.com/users/bensigelman/gists{/gist_id}","starred_url":"https://api.github.com/users/bensigelman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bensigelman/subscriptions","organizations_url":"https://api.github.com/users/bensigelman/orgs","repos_url":"https://api.github.com/users/bensigelman/repos","events_url":"https://api.github.com/users/bensigelman/events{/privacy}","received_events_url":"https://api.github.com/users/bensigelman/received_events","type":"User","site_admin":false},"created_at":"2016-10-11T23:53:48Z","updated_at":"2016-10-11T23:53:48Z","body":"I'm going to close this since the site has been live for the better part of 24h now -- thanks again, @reimertz @fractaly for all of the hard work and @pritianka for coordinating!"}}
{"actor":{"display_login":"bensigelman"}}