README.md for pingapp should describe use cases, scenarios, deployment vision

[nealmcb]

We need more than a sentence description of pingapp in the README. This is the first page I've heard about, and I can't figure out what its really about. Here are some early questions. Answers for any of them would help in the README.

• What is a typical use case for pingapp?
• Is there a demo or UI mockup site people can see?
• Who or what is "The admin" referred to in the early mockups?
• Who would run the servers?
• Is everyone supposed to run their own? Surely not.
• Would users sign up and coordinate ahead of time?
• What are the privacy issues and options?

Just linking to a newbie-friendly web page would help a lot. Perhaps one of these:

• http://blog.ushahidi.com/2013/09/24/2-tech-tools-for-emergencies-from-our-westgate-experience-ping-and-blood-donation/
• http://whiteafrican.com/tag/ping-app/

[dkobia]

Hi Neal... will update the README shortly. Here's some more detail: https://wiki.ushahidi.com/display/WIKI/Ping+App

[rjmackay]

@dkobia I've tried to cover some of this for V3 in the readme https://github.com/ushahidi/Lamu/blob/master/README.md
taking some inspiration from http://stevelosh.com/blog/2013/09/teach-dont-tell/#first-contact .. I tried to answer at least the basics:

1. what is this thing? what is it for?
2. why should I use it? (or not use it)
   then.. where to get more info and how to get started..

Beyond that I think users should hit the wiki or other docs (FAQ?)

[dkobia]

thanks @rjmackay I'll start making updates