Hacker News new | past | comments | ask | show | jobs | submit login

Just wanted to say that this is one of the most beautifully-documented projects I've ever used. Bravo!



Agreed, although I wish there was more documentation on the benefits of each feature, rather than just how to implement it.

E.g. there are dozens of pages on how to implement serializers, which is great, but the section on the benefits of serializers is only a paragraph or two long. So after reading all the documentation I'm still unclear as to the best practices on when vs when not to use them, and what the best practices are for endpoints that don't take advantage of them. I'm sure this kind of stuff is obvious to people who have been using it for a while, but after just going through the tutorial and then reading the relevant API pages I was still unclear on a bunch of issues.


Thanks Alex, I think that's a great point.

Please do feel free to follow this up by raising an issue on the repository - it'd be good to talk through some specifics about areas to improve.


Perhaps, but it's definitely wrong in places. I was working with a project this afternoon and the examples given didn't actually work. I should definitely take some notes on which bits were wrong, as it would be useful to have them fixed.




Join us for AI Startup School this June 16-17 in San Francisco!

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

Search: