19. The spec has problems.
• Unclear what things are optional (in reality: everything)
• Lots of room for different cities/implementations to work differently
• Open311 is about customer service; the city is focused on operations
• Date problems — formatting, time zones
• No paging
• No searching
• No provision for how to show extra/custom data
• No way to show detailed progress
• No way to handle “follow-ons”
20. The spec has problems.
• Unclear what things are optional (in reality: everything)
• Lots of room for different cities/implementations to work differently
• Open311 is about customer service; the city is focused on operations
• Date problems — formatting, time zones
• No paging
• No searching
• No provision for how to show extra/custom data
• No way to show detailed progress
• No way to handle “follow-ons”
34. Make it easy for others to participate.
http://opensourcedesign.is/blogging_about/import-designers/
35.
36.
37.
38. Good READMEs
• Quick and clear description
• A screenshot (seriously)
• Easy setup instructions
• Contribution instructions
• Recommended bugs to work on
39.
40. Be nice.
• Respond to bugs and PRs quickly (even if just to
say you can't get to it right away)
• Always use a friendly tone
• Be encouraging and constructive; don't say
what's wrong, suggest how it could be better
• Say thank you!