News for hackers. Stuff that matters.
Re:Show HN: Papa Parse 3 by colinramsay on Wednesday July 16, 2014 @10:25AM (#8042138)
This looks great, particularly the way the website breaks down the main functionality with plain explanations and code samples. I know that there's a bit of a bugbear with some people when it comes to reimplementing CSV parsing but having it in-browser could be very handy.
Re:Show HN: Papa Parse 3 by mholt on Wednesday July 16, 2014 @10:58AM (#8042331)
Thanks for your feedback. If it helps to know, the Q&A format on the homepage is the result of scratching my head for a while, thinking "How would I explain this to somebody? There's a lot to it, and it's all immediately relevant."

I eventually convinced myself that the last part isn't true. It could be disclosed in parts. So I decided to run the scenario in my mind instead: "I'll give somebody this library and imagine that they'll reveal their use cases one piece at a time and I'll help them through it." Then the conversation flowed naturally and came out while typing.

Re:Show HN: Papa Parse 3 by andrey-p on Wednesday July 16, 2014 @11:28AM (#8042522)
What really got me was the desperation in the "voice" of the questions, slowly being won over by a calm father figure. I've never had to parse CSV in the browser, but now I feel like I should. Powerful stuff!

I'm also a big fan of libraries where the library name is also the API (ie Papa Parse -> Papa.parse()). It just fills me with glee.

Re:Show HN: Papa Parse 3 by cheese1756 on Wednesday July 16, 2014 @11:45AM (#8042621)
Will the website itself be released under an open license? I could see this website format being useful for a ton of open source projects.
Re:Show HN: Papa Parse 3 by mholt on Wednesday July 16, 2014 @01:19PM (#8043200)
I'd be okay with that, I just hadn't considered it. By format do you mean design or content (or both)? And are you thinking a Creative Commons license?
Re:Show HN: Papa Parse 3 by cheese1756 on Monday July 28, 2014 @04:03AM (#8095651)
I meant the design, since the page created such a clear template that would be fantastic for future open source projects to modify. But if you want to release the content in the open too, all the better. I just think that a lot of open source projects which struggle with onboarding would be greatly benefited by using the page as a base.
Re:Show HN: Papa Parse 3 by findjashua on Wednesday July 16, 2014 @11:20AM (#8042458)
love the conversational style of the documentation!
Re:Show HN: Papa Parse 3 by ohitsdom on Wednesday July 16, 2014 @11:04AM (#8042363)
Loved the format!
Re:Show HN: Papa Parse 3 by jwblackwell on Wednesday July 16, 2014 @10:43AM (#8042255)
I thought this as well, really good way to explain the benefits and features - through common questions.
Re:Show HN: Papa Parse 3 by tonyhb on Wednesday July 16, 2014 @10:45AM (#8042262)
Yeah, it explains it so well. Being able to relate to each point and feature is such a key part of explaining your service.

This site might be for a CSV parsing library and not a startup, but it does a better job of telling a story than most startups do. And, to me, that's how you sell and engage users.