{"action":"created","issue":{"url":"https://api.github.com/repos/rurema/doctree/issues/1488","repository_url":"https://api.github.com/repos/rurema/doctree","labels_url":"https://api.github.com/repos/rurema/doctree/issues/1488/labels{/name}","comments_url":"https://api.github.com/repos/rurema/doctree/issues/1488/comments","events_url":"https://api.github.com/repos/rurema/doctree/issues/1488/events","html_url":"https://github.com/rurema/doctree/issues/1488","id":368480694,"node_id":"MDU6SXNzdWUzNjg0ODA2OTQ=","number":1488,"title":"Tutorial を改善","user":{"login":"scivola","id":294125,"node_id":"MDQ6VXNlcjI5NDEyNQ==","avatar_url":"https://avatars0.githubusercontent.com/u/294125?v=4","gravatar_id":"","url":"https://api.github.com/users/scivola","html_url":"https://github.com/scivola","followers_url":"https://api.github.com/users/scivola/followers","following_url":"https://api.github.com/users/scivola/following{/other_user}","gists_url":"https://api.github.com/users/scivola/gists{/gist_id}","starred_url":"https://api.github.com/users/scivola/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/scivola/subscriptions","organizations_url":"https://api.github.com/users/scivola/orgs","repos_url":"https://api.github.com/users/scivola/repos","events_url":"https://api.github.com/users/scivola/events{/privacy}","received_events_url":"https://api.github.com/users/scivola/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2018-10-10T03:33:27Z","updated_at":"2018-10-11T12:40:34Z","closed_at":null,"author_association":"NONE","body":"Tutorial でつまずく人もいるかと思います（私）。もう少し分かりやすくなると入って来やすいのではないかと思います。\r\n\r\n◎データベースの作成\r\n\r\n「2. データベースの作成」に\r\n\r\n> typoの修正くらいならデータベースを作る必要はありません\r\n\r\nとありますが，どんな場合にデータベースが必要なのでしょうか。\r\n\r\nまた，例ではデータベースを `rubydoc/refm/api` の下に作ることになっていますが，`rubydoc/refm/api` 以外のファイルの場合はどうすればいいのでしょうか。\r\n\r\n◎ソースの clone\r\n\r\nソースを clone する手順が二回出てきますが最初のだけでいいように思います。\r\n\r\n◎ブランチ名\r\n\r\nブランチ名についてのルールもしくは望ましい流儀はありますか。\r\n非 ASCII 文字を使ってよいかどうか，などが知りたいと思います。\r\n\r\n◎push の仕方\r\n\r\nオリジナル（rurema/doctree）から clone しているのに，自分のリポジトリーに push するコマンドが\r\n\r\n> git push origin ブランチ名\r\n\r\nとなっています。\r\n\r\n◎プレビュー\r\n\r\n「3.5 編集内容をプレビューする」と「4. プレビュー」がかぶっているように思います。\r\n"},"comment":{"url":"https://api.github.com/repos/rurema/doctree/issues/comments/428939819","html_url":"https://github.com/rurema/doctree/issues/1488#issuecomment-428939819","issue_url":"https://api.github.com/repos/rurema/doctree/issues/1488","id":428939819,"node_id":"MDEyOklzc3VlQ29tbWVudDQyODkzOTgxOQ==","user":{"login":"scivola","id":294125,"node_id":"MDQ6VXNlcjI5NDEyNQ==","avatar_url":"https://avatars0.githubusercontent.com/u/294125?v=4","gravatar_id":"","url":"https://api.github.com/users/scivola","html_url":"https://github.com/scivola","followers_url":"https://api.github.com/users/scivola/followers","following_url":"https://api.github.com/users/scivola/following{/other_user}","gists_url":"https://api.github.com/users/scivola/gists{/gist_id}","starred_url":"https://api.github.com/users/scivola/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/scivola/subscriptions","organizations_url":"https://api.github.com/users/scivola/orgs","repos_url":"https://api.github.com/users/scivola/repos","events_url":"https://api.github.com/users/scivola/events{/privacy}","received_events_url":"https://api.github.com/users/scivola/received_events","type":"User","site_admin":false},"created_at":"2018-10-11T12:40:34Z","updated_at":"2018-10-11T12:40:34Z","author_association":"NONE","body":"データベースについてですが，Tutorial の中に，作ったデータベースを使う工程が書かれていないので（私が）よく理解できないのだと思います。\r\nえっと，「分岐など文書のロジックに関わる記述が間違ってると，データベースを作るときにエラーで弾いてくれるので気がつく」といったようなことなのでしょうか？\r\n\r\n「rubydoc/refm/api 以外のファイルの場合」というのは，実際，私がやったように，rubydoc/refm/doc 下の文書のプルリクエストを作る人もいると思いますので，データベースをどこに作ればいいのか書いてないと困ると思いました。\r\n（私はデータベースが何のためにあるのか分かってないので，とんちんかんなことを書いているかもしれません）\r\n\r\nそれから，\r\n\r\n> 差分いただけると一番ありがたいですけどどうでしょう？\r\n\r\nというのは，push の仕方についての記述の改善案を diff 形式で，ということでしょうか？\r\n手順としては，「Edit」ボタンを押して出てくる Markdown をローカルに保存して，修正案を作って diff を取ってこの issue のコメントとして貼り付ければよろしいでしょうか？\r\n"}}
{"actor":{"display_login":"scivola"}}