Discussion on: Jelly Fin: Looking For Contributors

[Khaled Garbaya]

Hey Jonathan,

This looks good and I love the idea, here's my feedback:

• To get people attracted to your repo I think having a good README is a good start, Let people know what is it about and how they can contribute/run and test the project locally.

• Mentioned that Contribution is always welcome

• Marks the easy issues as first-good-issue or help-wanted and add more details I would even point to some code where to start

[Miguel Ruiz]

Totally agree. Adding a wiki could be also useful. Some screenshots too.

[Jonathan Irvin]

Wiki added. What kind of pages do you think I should have?

[Miguel Ruiz]

I would start writing an introduction with the state of art. Why you started the project, if there is any others projects doing the same. A small diagram of the technologies that you are using/architect.

Of course in README.md at least how to start the project locally and a small explanation to new developers.

Reading what it's there didn't make me understand exactly what's all this about.

Just my opinion. I hope my feedback helps you.

[Jonathan Irvin]

Thank you! I've been looking for feedback on where to start. What is my README missing?

[Khaled Garbaya]

the First thing a README IMO is a clear sentence (TL;DR version) what is the repo about.

After that a table of content for easy navigation.

Sections can be :

• Core Features (this to answer the question, is this project for me? is it gonna solve my problems?)
• Pre-requisites && Installation (how to install/run the project)
• Getting started (small runnable snippet of code if applicable)
• Troubleshooting (common problems and how to fix them)
• Get involved ( few nice words to encourage people and link to CONTRIBUTION.md)
• LICENSE
• CODE OF CONDUCT (really important to protect you and people)

for CONTRIBUTION.md you get some inspiration from famous repos, it's basically a spec document on how to run tests, add PR, code style and so on