{"action":"created","issue":{"url":"https://api.github.com/repos/nodejs/docs/issues/42","labels_url":"https://api.github.com/repos/nodejs/docs/issues/42/labels{/name}","comments_url":"https://api.github.com/repos/nodejs/docs/issues/42/comments","events_url":"https://api.github.com/repos/nodejs/docs/issues/42/events","html_url":"https://github.com/nodejs/docs/issues/42","id":107757159,"number":42,"title":"A section for 'Best practices'","user":{"login":"silverwind","id":115237,"avatar_url":"https://avatars.githubusercontent.com/u/115237?v=3","gravatar_id":"","url":"https://api.github.com/users/silverwind","html_url":"https://github.com/silverwind","followers_url":"https://api.github.com/users/silverwind/followers","following_url":"https://api.github.com/users/silverwind/following{/other_user}","gists_url":"https://api.github.com/users/silverwind/gists{/gist_id}","starred_url":"https://api.github.com/users/silverwind/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/silverwind/subscriptions","organizations_url":"https://api.github.com/users/silverwind/orgs","repos_url":"https://api.github.com/users/silverwind/repos","events_url":"https://api.github.com/users/silverwind/events{/privacy}","received_events_url":"https://api.github.com/users/silverwind/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":7,"created_at":"2015-09-22T17:02:59Z","updated_at":"2015-10-08T17:34:29Z","closed_at":null,"body":"There's an issue (https://github.com/nodejs/node/issues/2165) with HFS+ where unicode paths returned by the file system are not necessarily the same as the ones that were written because HFS+ forces certain code points to be in NFD form apparently. The consensus looks to be to avoid unicode normalization in node and instead delegate the normalization task to the user.\r\n\r\nI could litter all related methods in `fs` and `process` with a note that strings aren't necessary comparable depending on file system, but I think a better approach would be a  section where we could advice on pitfalls like this."},"comment":{"url":"https://api.github.com/repos/nodejs/docs/issues/comments/146632406","html_url":"https://github.com/nodejs/docs/issues/42#issuecomment-146632406","issue_url":"https://api.github.com/repos/nodejs/docs/issues/42","id":146632406,"user":{"login":"silverwind","id":115237,"avatar_url":"https://avatars.githubusercontent.com/u/115237?v=3","gravatar_id":"","url":"https://api.github.com/users/silverwind","html_url":"https://github.com/silverwind","followers_url":"https://api.github.com/users/silverwind/followers","following_url":"https://api.github.com/users/silverwind/following{/other_user}","gists_url":"https://api.github.com/users/silverwind/gists{/gist_id}","starred_url":"https://api.github.com/users/silverwind/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/silverwind/subscriptions","organizations_url":"https://api.github.com/users/silverwind/orgs","repos_url":"https://api.github.com/users/silverwind/repos","events_url":"https://api.github.com/users/silverwind/events{/privacy}","received_events_url":"https://api.github.com/users/silverwind/received_events","type":"User","site_admin":false},"created_at":"2015-10-08T17:34:29Z","updated_at":"2015-10-08T17:34:29Z","body":"I'll read up on that on the weekend, thanks. \r\n\r\nI think it would fit nicely in a separate section here at https://nodejs.org/en/docs/, which is likely managed on the [website repo](https://github.com/nodejs/new.nodejs.org). Of course we should like to it eventually from `fs` and the relevant `process` methods."}}