first list generation 🎉

README.md

@@ -1,2 +1,28 @@
-# coffeechat
+# Coffee Chat
-List of awesome people offering their time for free to have a "coffee chat" with others about different topics, mostly in a mentorship kind of way.
+
+List of awesome people offering their time **for free** to have a "coffee chat" with others about different topics, mostly in a mentorship kind of way.
+
+- **[Frédéric Harper](https://calendly.com/fharper/coffee) ([LinkedIn](https://www.linkedin.com/in/fredericharper), [Twitter](https://twitter.com/fharper)), Director of Developer Relations at Mindee:** Open-Source, SaaS Architecture, Developer Relations, Developers Documentation, Community Building, Personal Branding, Starting in Tech, Job Search, Cats, Coffee, Microbrewery Beer, Travelling, Mental Health, Anything else)
+
+## Add yourself to this list
+
+To add your name to this list, you simply need to add another person object in [people.json](people.json). You can simply copy someone else, and change the information. If you don't want to share a piece of information, just leave the value of the field empty. Once done, please do a pull request. If you have no idea how all this works, you can simply send me your information by [email](mailto:hi@fred.dev), and I'll add you to the list myself with pleasure.
+
+⚠️ **Warning**: only add yourself to this list!
+
+## Remove yourself from this list
+
+Simply create a pull request by removing your people definition from [people.json](people.json). As for adding yourself to the list if you are not a technical person, just send me an [email](mailto:hi@fred.dev) and I'll do it for you.
+
+## Future plans
+
+I put this up quickly, and don't have more time this week to finalize what I had in mind, so here's some things left to do.
+
+- Generate a second list by location (when we'll have more people)
+- Generate a third list by discussion topics (when we'll have more people)
+- Add GitHub Action for JSON linting
+- Add GitHub Action for automatic README generation
+- Add GitHub Action for links validation
+- Create pull request template
+- Create a CONTRIBUTION.md
+- Better formatting of the list including city & country (suggestions welcome here).