Hacker Newsnew | past | comments | ask | show | jobs | submit | grantjgordon's commentslogin

The Rethink docs truly are incredible.

Do you have any guides or books you recommend for writing good documentation? What software did you use to produce Rethink?

Sorry to see Rethink go.


The documentation is all maintained in Markdown and built with Jekyll, so it's pretty straightforward. There were a few custom Jekyll tags. For writing, I used the venerable Mac editor BBEdit; obviously any text editor can do a fine job here, but there are some subtleties in BBEdit I liked. Its "open file by name" command can open multiple files with the same name at once, for instance, and its find/replace functionality goes above and beyond the call of duty.

For books/guides, it's hard to say. Find documentation you like a lot and think about what makes it good--the organization/taxonomy is really important to pay attention to, as well as the tone (formal, conversational, weird, etc.). As shocking as this might be around here, the _Microsoft Manual of Style_ is useful as a specifically technical guide, and it's good to have a relative recent edition of the _Chicago Manual of Style_ kicking around as a reference. And, just being familiar with standard grammar and punctuation rules is important. A lot of people aren't. (A lot of people who aren't still think they are.)


Hahaha. That is surprising! Thanks for the helpful advice.


I know several engineers on my team would love that.


Would love to hear about any other features you think your team might find useful.


Love the design overall. You might consider adding some more market-position content. E.g. How do you see Hublo as different than, say, Adroll?


The same as AdRoll conceptually, except we let people in charge of the campaigns (usually marketers, non-developers) add events and segmenting options on their own.

Clicks, form submits, time on site, number of sessions, last seen aren't available in AdRoll. We hope that by making those readily available, we'll be one step closer to make retargeting ads feel more like conversations, and less like...ads!


Thanks, that's helpful!


Agreed. Maybe something like "Ridiculously fast local faceted search" would be more appropriate?


Has anyone comparison tested Impala + EMR and Redshift?


It's unlikely to be much different than the recent Berkeley benchmarks, since they all ran on AWS: https://amplab.cs.berkeley.edu/benchmark/


Thanks! Hadn't seen these before.


Note that any such comparison would have to including load/conversion time for each system.


Here's to hoping this goes through and that google can turn iProvo around!


You might add a little more definition around movie title / poster / button combinations. Once you scroll away from the top or the bottom it's not immediately apparent which belong to which unless you really look at the poster.


Any example shirts?


Way to go! Web OS always had such promise -- I hope that it can make a bigger impact now that it's been freed from the shackles of the dying Palm.


Thanks!


Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: