4 ms·

Holy wall of text slides Batman!

canistr 12y ago
Agreed. The title makes it seem that the 18 slides are easily digestible when in fact, it's pretty dense and it's a slog just to even glance through them.
- Nycto 12y ago
  A slog indeed. For anyone interested, this is the article I hand out when someone asks me about designing a REST API: http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api?hn http://www.vinaysahni.com/best-practices-for-a-pragmatic-res... And here is the HN discussion from when it was originally posted: https://news.ycombinator.com/item?id=5819231 https://news.ycombinator.com/item?id=5819231
  - surajgupta 12y ago
    That's dramatic. Learning any new topic, particularly one as involved as REST, require some investment of time. Your blog post has FAR more content than my slides do. And your approach is from a "best practices" point-of-view. So the arc of our stories is necessarily different. I'm glad that blogs enable people to learn the same topic in multiple ways. It's a good for everyone. I just wish people would avoid self-promotion on top of other people's backs. =)
    - Nycto 12y ago
      I have found the article I linked to be incredibly digestible for people learning REST, which is why I recommend it; regardless of the point-of-view. It's what I think is missing from your slides. You might be able to solve this in the context of an actual presentation, but taken as just the slides, it's very dense. Also, this isn't self-promotion at all. I'm not in any way associated with that blog. I just like the content. Different perspectives and learning styles, I suppose. I'm not trying to be argumentative, just briefly laying out my thoughts. Cheers
- PeterWhittaker 12y ago
  Different strokes, I guess: while the slides were info-rich, I found them quite accessible and readable. Thanks, surajgupta, good work.
  - surajgupta 12y ago
    thanks, Peter! I slaved over words in that deck, so getting this kind of feedback makes it all worth it!
surajgupta 12y ago
Yeah, as I said in my blog post this is certainly text-heavy. The more appropriate format would have been a article, but I wanted an excuse to play with SlideShare. This deck could have be thinner with more visuals if it were accompanied by audio or video as in a proper talk. But I didn't have the time to do that, so I wanted the deck to be self-contained. Just think about it as a textual blog post in slide format.
- simonw 12y ago
  Your content is great, but this really is a horrible abuse of SlideShare. I suggest pulling the content out in to an article as well. (One side effect: I wanted to save this to Pocket to read later on a flight, but couldn't because it was slides, not HTML).
  - surajgupta 12y ago
    I think "horrible" is pretty strong and perhaps you meant a lighter shade of gray :-) It is unfortunate that this doesn't work on Pocket. Thanks for letting me know!

Agreed. The title makes it seem that the 18 slides are easily digestible when in fact, it's pretty dense and it's a slog just to even glance through them.

Nycto 12y ago
A slog indeed. For anyone interested, this is the article I hand out when someone asks me about designing a REST API: http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api?hn http://www.vinaysahni.com/best-practices-for-a-pragmatic-res... And here is the HN discussion from when it was originally posted: https://news.ycombinator.com/item?id=5819231 https://news.ycombinator.com/item?id=5819231
- surajgupta 12y ago
  That's dramatic. Learning any new topic, particularly one as involved as REST, require some investment of time. Your blog post has FAR more content than my slides do. And your approach is from a "best practices" point-of-view. So the arc of our stories is necessarily different. I'm glad that blogs enable people to learn the same topic in multiple ways. It's a good for everyone. I just wish people would avoid self-promotion on top of other people's backs. =)
  - Nycto 12y ago
    I have found the article I linked to be incredibly digestible for people learning REST, which is why I recommend it; regardless of the point-of-view. It's what I think is missing from your slides. You might be able to solve this in the context of an actual presentation, but taken as just the slides, it's very dense. Also, this isn't self-promotion at all. I'm not in any way associated with that blog. I just like the content. Different perspectives and learning styles, I suppose. I'm not trying to be argumentative, just briefly laying out my thoughts. Cheers
PeterWhittaker 12y ago
Different strokes, I guess: while the slides were info-rich, I found them quite accessible and readable. Thanks, surajgupta, good work.
- surajgupta 12y ago
  thanks, Peter! I slaved over words in that deck, so getting this kind of feedback makes it all worth it!

surajgupta 12y ago

Yeah, as I said in my blog post this is certainly text-heavy. The more appropriate format would have been a article, but I wanted an excuse to play with SlideShare. This deck could have be thinner with more visuals if it were accompanied by audio or video as in a proper talk. But I didn't have the time to do that, so I wanted the deck to be self-contained. Just think about it as a textual blog post in slide format.

simonw 12y ago
Your content is great, but this really is a horrible abuse of SlideShare. I suggest pulling the content out in to an article as well. (One side effect: I wanted to save this to Pocket to read later on a flight, but couldn't because it was slides, not HTML).
- surajgupta 12y ago
  I think "horrible" is pretty strong and perhaps you meant a lighter shade of gray :-) It is unfortunate that this doesn't work on Pocket. Thanks for letting me know!