Live data from Hacker News

Ask HN: Review DocumentCloud.org

news.ycombinator.com

1–10 of 25 posts

Ask HN: Review DocumentCloud.org

#1
'Morning, HN. For the last year and a half, @samuelclay and I have been working on DocumentCloud, a non-profit organization that makes it easier to analyze, annotate, and publish the primary source documents behind the news.

We just opened up the public version of the workspace, and I'd be obliged if y'all could take a look, and share your thoughts. There has been a lot of interest in seeing a real-world example of a webapp that uses Backbone.js, Underscore.js, and Jammit -- and this is the application that all of our open-source libraries have been extracted from.

To get your hands dirty, visit documentcloud.org/public, and try a search for "filter: annotated". Then, pop open your JS console, and you can play around with the Backbone models:

    Documents.first().get("title");

    Documents.map(function(doc){ return doc.get("title"); });

    Documents.first().notes.fetch();

    Documents.first().notes.first().set({title: "Testing..."});
... don't worry, that last one didn't persist anything to the server. If you try a .save(), it'll be denied.

A couple other fun things to try:

* Drag a box to select a couple documents, and choose "Analyze -> View Timeline".

* Pop open the entities tab, and click on "show pages" next to an entity to view all of their mentions in the text.

* Click on a document's page count...

I'd love to hear your thoughts, from both technical and design perspectives, and would be glad to answer any questions that you have about the app.

Re: Ask HN: Review DocumentCloud.org

#2
Clickable links:

* Open-source projects: http://www.documentcloud.org/opensource

* Public search: http://www.documentcloud.org/public/#search/

* Just annotated docs: http://www.documentcloud.org/public/#search/filter%3A%20anno...

* Deepwater Horizon Spill Docs: http://www.documentcloud.org/public/#search/deepwater%20hori...

Re: Ask HN: Review DocumentCloud.org

#5
I'd like to just give a big shoutout to the DocumentCloud team and their huge contributions to the open source community. I've been using underscore, backbone.js, and jammit extensively over the past few months, and it's been a joy to work with, and also well documented enough for me to extend and customize.

So, to the DocumentCloud team I say: a big THANK YOU!

Re: Ask HN: Review DocumentCloud.org

#6
It looks great, however the first thing I thought of is Scribd. The NYT Dealbook uses them extensively: http://www.scribd.com/DealBook

I don't mean "They did it don't bother". It might be that your are making a non-profit Scribd focused on social news, and you'll be better because _________.

There is a need for this. There is a general distrust of media, and people want to make their own decision -- your empowering them.

PS. I like the design.

Re: Ask HN: Review DocumentCloud.org

#8

It looks great, however the first thing I thought of is Scribd. The NYT Dealbook uses them extensively: http://www.scribd.com/DealBook I don't mean "They did it don't bother". It might be that your are making a non-profit Scribd focused on social news, and you'll be better because _________. There is a need for this. There is a general distrust of media, and people want to make their own decision -- your empowering t…

Fortunately, DocumentCloud has a very different mission than Scribd, and isn't competing with them in any meaningful way. Scribd is a "YouTube for documents", where anyone can upload and share docs, with all the requisite advertising that entails.

We're a nonprofit organization funded by the Knight Foundation to help make primary source documents accessible. Upload access to DocumentCloud is restricted to journalists -- the current list of contributors can be found here:

http://www.documentcloud.org/contributors

As to the Document Viewer, which is probably what you're talking about (the equivalent of Scribd's embedded viewer), it's funny that you mention the Times, because it's their project. Alan McLean, at the Interactive News desk, created the document viewer for nytimes.com, and they make extensive use of it there (apart from Dealbook). It's also an HTML5 viewer, not a Flash viewer.

http://documents.nytimes.com/court-battle-over-rahm-emanuels...

http://www.documentcloud.org/#search/group%3A%20nytimes

PS. The design is thanks to the very talented Folkert Gorter (superfamous.com)

Re: Ask HN: Review DocumentCloud.org

#9
If you're a web developer, backbone.js will teach you how to make gui apps!

I've been working with MVC style frameworks for quite a while on the server-side but until backbone I've never been able to get my head around how to create a gui app using MVC. It was never clear where and how to put things and before I knew it, everything would go spaghetti on me.

I've done lots of js and lots of js intensive apps and I always hated it because of all the lack of structure and mix of concerns everywhere.

For the last two months, I've been using backbone.js, underscore.js, jammit and coffeescript (which is also made by jashkenas) in a quite complex app. Because of them I was able to massively rework things based on changing requirements without ending up with dead code, or strange pieces that are somehow working but not really needed.

I can't say this enough. Backbone.js really helped put order in my code and it was so easy to pick up that I am convinced you're really hurting yourself by not using it. The documentation is amazingly well done and has real examples of how you'd use the code, instead of just being generated from arguments and other relatively unimportant stuff.

Thanks jashkenas and samuelclay! And congrats on finally launching documentcloud.org. Keep kicking ass!

Re: Ask HN: Review DocumentCloud.org

#10
post #5

I'd like to just give a big shoutout to the DocumentCloud team and their huge contributions to the open source community. I've been using underscore, backbone.js, and jammit extensively over the past few months, and it's been a joy to work with, and also well documented enough for me to extend and customize. So, to the DocumentCloud team I say: a big THANK YOU!

Thanks James. For the curious ... James' app is: http://www.quietwrite.com/
Post reply on HN