{"action":"created","issue":{"url":"https://api.github.com/repos/opencv/opencv/issues/11423","repository_url":"https://api.github.com/repos/opencv/opencv","labels_url":"https://api.github.com/repos/opencv/opencv/issues/11423/labels{/name}","comments_url":"https://api.github.com/repos/opencv/opencv/issues/11423/comments","events_url":"https://api.github.com/repos/opencv/opencv/issues/11423/events","html_url":"https://github.com/opencv/opencv/issues/11423","id":318675982,"number":11423,"title":"Better bring out info on contributing to docs + clarify search bars in new documentation","user":{"login":"kerstin","id":559572,"avatar_url":"https://avatars0.githubusercontent.com/u/559572?v=4","gravatar_id":"","url":"https://api.github.com/users/kerstin","html_url":"https://github.com/kerstin","followers_url":"https://api.github.com/users/kerstin/followers","following_url":"https://api.github.com/users/kerstin/following{/other_user}","gists_url":"https://api.github.com/users/kerstin/gists{/gist_id}","starred_url":"https://api.github.com/users/kerstin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kerstin/subscriptions","organizations_url":"https://api.github.com/users/kerstin/orgs","repos_url":"https://api.github.com/users/kerstin/repos","events_url":"https://api.github.com/users/kerstin/events{/privacy}","received_events_url":"https://api.github.com/users/kerstin/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-04-28T23:22:18Z","updated_at":"2018-04-28T23:33:12Z","closed_at":null,"author_association":"NONE","body":"Hi there, it took me at least 15 minutes to find out how to contribute to the docs aka [this link](https://docs.opencv.org/master/d4/db1/tutorial_documentation.html) at the very end of the [How to contribute](https://github.com/opencv/opencv/wiki/How_to_contribute) page in the wiki.\r\n\r\nPlease add it to the repo's README or somewhere at the _top_ of the How To. Seeing as the How To talks about \"enthusiastic coders\" and \"contributing code\" right from the beginning, it's not obvious at all that _at the very end_, it does eventually contain a one-sentence reference to documentation...\r\n\r\nThe switch to a new documentation system is also confusing and not immediately obvious to newcomers to the project. Took me a while to figure out that the 2.4 Sphinx docs (which Google led me to, and which I meant to contribute to) are not part of this repo / meant to be updated (?). Finally, I thought the page I was looking at was gone in the new version (and hence the code) because there were no results for it when searching the new docs. Turns out there are two search bars, and only the less visible Google one at the top (not the one in the menu bar that says \"Search\") brings up the page."},"comment":{"url":"https://api.github.com/repos/opencv/opencv/issues/comments/385212511","html_url":"https://github.com/opencv/opencv/issues/11423#issuecomment-385212511","issue_url":"https://api.github.com/repos/opencv/opencv/issues/11423","id":385212511,"user":{"login":"kerstin","id":559572,"avatar_url":"https://avatars0.githubusercontent.com/u/559572?v=4","gravatar_id":"","url":"https://api.github.com/users/kerstin","html_url":"https://github.com/kerstin","followers_url":"https://api.github.com/users/kerstin/followers","following_url":"https://api.github.com/users/kerstin/following{/other_user}","gists_url":"https://api.github.com/users/kerstin/gists{/gist_id}","starred_url":"https://api.github.com/users/kerstin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kerstin/subscriptions","organizations_url":"https://api.github.com/users/kerstin/orgs","repos_url":"https://api.github.com/users/kerstin/repos","events_url":"https://api.github.com/users/kerstin/events{/privacy}","received_events_url":"https://api.github.com/users/kerstin/received_events","type":"User","site_admin":false},"created_at":"2018-04-28T23:33:12Z","updated_at":"2018-04-28T23:33:12Z","author_association":"NONE","body":"Additionally, for Mac users it'd be great if along with the links to download and install instructions, you could mentioned that Doxygen is available via Homebrew. I sadly can't open issues over at @doxygen to make them aware that that's missing from their own pages. "}}
{"actor":{"display_login":"kerstin"}}