moufette icon indicating copy to clipboard operation
moufette copied to clipboard

Explain what this code does in ReadMe

Open rimutaka opened this issue 4 years ago • 4 comments

The project description at the top sounds interesting, but how does it work?

A few lines describing the product, how it works and what the benefit of using it at the top of readme.md would help. It would be good to have an example and a few screenshots.

rimutaka avatar Apr 25 '20 02:04 rimutaka

@rimutaka I have updated the readme, lmk what you think. 10x

jamalx31 avatar Apr 25 '20 18:04 jamalx31

Jamal, it's getting there.

Moufette is an open-soruce [????], built for developers. - an open source what? An app? A library? What does it do exactly?

You need to reduce it to a very simple definition that speaks to your target user.

Here is a made-up example: MF is an embedable JS widget with such and such back-end to collect user feedback with screenshots. Make it easeir for your users to help you build a better app.

A few screenshots of what the UI may look like will help.

Then you can go into all the technical details on how to install and use it.

rimutaka avatar Apr 25 '20 22:04 rimutaka

@rimutaka thank you so much. really appreciate the feedback. I've updated the description and added screenshots.

jamalx31 avatar Apr 26 '20 17:04 jamalx31

Nice :) I'd drop the badger illustration and add a sample embed snippet.

Ping me when you add more contents for another round of reviews. I'm interested to see how your docs progress.

rimutaka avatar Apr 26 '20 21:04 rimutaka