{"action":"created","issue":{"url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/1568","labels_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/1568/labels{/name}","comments_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/1568/comments","events_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/1568/events","html_url":"https://github.com/syl20bnr/spacemacs/issues/1568","id":75019715,"number":1568,"title":"Convert Spacemacs documentation into Org","user":{"login":"tuhdo","id":4818719,"avatar_url":"https://avatars.githubusercontent.com/u/4818719?v=3","gravatar_id":"","url":"https://api.github.com/users/tuhdo","html_url":"https://github.com/tuhdo","followers_url":"https://api.github.com/users/tuhdo/followers","following_url":"https://api.github.com/users/tuhdo/following{/other_user}","gists_url":"https://api.github.com/users/tuhdo/gists{/gist_id}","starred_url":"https://api.github.com/users/tuhdo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tuhdo/subscriptions","organizations_url":"https://api.github.com/users/tuhdo/orgs","repos_url":"https://api.github.com/users/tuhdo/repos","events_url":"https://api.github.com/users/tuhdo/events{/privacy}","received_events_url":"https://api.github.com/users/tuhdo/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/syl20bnr/spacemacs/labels/documentation%20:-%3E","name":"documentation :->","color":"fbca04"},{"url":"https://api.github.com/repos/syl20bnr/spacemacs/labels/enhancement%20:-D","name":"enhancement :-D","color":"84b6eb"},{"url":"https://api.github.com/repos/syl20bnr/spacemacs/labels/Org","name":"Org","color":"207de5"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":47,"created_at":"2015-05-10T22:50:11Z","updated_at":"2015-06-12T17:05:02Z","closed_at":null,"body":"The reason:\r\n\r\n- Better look and feel since Emacs supports Org natively. This is one [example](https://pbs.twimg.com/media/CDOs6ZXWIAAEseL.png) out of the box in Spacmeacs. (original image from [this twitter post](https://twitter.com/acid2/status/591006096631980032)). To have a clean view for reading documentation written in Org, set the following options:\r\n\r\n```elisp\r\n(setq org-hide-emphasis-markers t)\r\n(setq org-hide-leading-stars t)\r\n```\r\n\r\nWith the first option, you won't see markup characters like `*...*` anymore. Very good for reading Org documents.\r\n\r\n- For the above reason, we won't have to use `gh-md` anymore. No more waiting for remote rendering. To edit and contribute, simply `C-x C-q` or `SPC b v` to disable `read-only-mode`.\r\n\r\n- Org produces sophisticated and better HTML output. Proof: Everything in my website: http://tuhdo.github.io/ is produced by Org. It can even use your own theme for syntax coloring in generated output.\r\n\r\n- You can export in other formats as well, such as PDF or Postscript or Markdown. So, you can create a complete Spacemacs manual in PDF if you write in Org.\r\n\r\n- Learning Org worth it, believe me. You can later use Org for more things, i.e. evaluate inline code, save internet links or local files or directory, or store magit commits to open later etc...\r\n\r\n- It's a nice way to show the capacity of Org and Emacs to Vim users.\r\n\r\n- Writing Org is easier than markdown, since we can use snippets and automatic indentation.\r\n\r\n- Many Vim users switch to Emacs for Org. Allow writing documents in Org gives them a chance to exercise it for practical purpose."},"comment":{"url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/comments/111558767","html_url":"https://github.com/syl20bnr/spacemacs/issues/1568#issuecomment-111558767","issue_url":"https://api.github.com/repos/syl20bnr/spacemacs/issues/1568","id":111558767,"user":{"login":"cpaulik","id":380927,"avatar_url":"https://avatars.githubusercontent.com/u/380927?v=3","gravatar_id":"","url":"https://api.github.com/users/cpaulik","html_url":"https://github.com/cpaulik","followers_url":"https://api.github.com/users/cpaulik/followers","following_url":"https://api.github.com/users/cpaulik/following{/other_user}","gists_url":"https://api.github.com/users/cpaulik/gists{/gist_id}","starred_url":"https://api.github.com/users/cpaulik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cpaulik/subscriptions","organizations_url":"https://api.github.com/users/cpaulik/orgs","repos_url":"https://api.github.com/users/cpaulik/repos","events_url":"https://api.github.com/users/cpaulik/events{/privacy}","received_events_url":"https://api.github.com/users/cpaulik/received_events","type":"User","site_admin":false},"created_at":"2015-06-12T17:05:02Z","updated_at":"2015-06-12T17:05:02Z","body":"@tuhdo The `org-kbd` face you introduced hides the `~` character leading to wrongly indented tables \r\n\r\n![image](https://cloud.githubusercontent.com/assets/380927/8135229/e17e926c-1135-11e5-8833-d569622045c5.png)\r\n"}}