react-email icon indicating copy to clipboard operation
react-email copied to clipboard

[Docs] Improve Docs with the problem statement

Open niloysikdar opened this issue 2 years ago • 12 comments

Description:

  • We need to describe the problem we're solving and also the solution on how our package is solving that particular problem.

Outcome:

  • Detailed writeup about the problem and the approach for the solution in the README.md file.

niloysikdar avatar Oct 10 '22 16:10 niloysikdar

hi! if you could give me more information on the specific problems and solutions mentioned, I would love to work on this!

Logan-kwan avatar Oct 10 '22 16:10 Logan-kwan

Hi @Logan-kwan , thanks for showing interest to work on this issue. You can watch this video to get complete info about the package.

Do let me know if you have any queries.

Also, make sure to drop a star on the repo to support the project and open-source🌟😇

niloysikdar avatar Oct 11 '22 05:10 niloysikdar

just a quick question: do you have a preference on where to put the problem and suggested solution?

Logan-kwan avatar Oct 11 '22 21:10 Logan-kwan

Hmmm, I think it will be best to put it at the very start of the README after the name and description of the package.

niloysikdar avatar Oct 12 '22 06:10 niloysikdar

Hey @niloysikdar, would just like to ask if any help is further required for this issue. Would like to contribute to it?

Anurag2293 avatar Jan 22 '23 11:01 Anurag2293

Sure @Anurag2293

niloysikdar avatar Jan 22 '23 12:01 niloysikdar

Can you guide me on how to get started? I am a complete beginner in open source, though I am well versed in Git & GitHub. Do I need to clone this project in my local device for the documentation part as well ?

Anurag2293 avatar Jan 23 '23 06:01 Anurag2293

Yes @Anurag2293, first you need to create a fork of the repo and then clone it into your local machine.

Then go the the /docusaurus folder and enter yarn command to install the dependencies for the docs. After installing the dependencies, run yarn start to start the development server for docusaurus. Go to localhost:3000 and you'll be able to see the docusaurus site up and running.

Do let me know if you have any queries or need any help. Don't forget to join the gitter channel for the discussions.

Also, make sure to drop a star on the repo to support the project and open-source🌟😇

niloysikdar avatar Jan 23 '23 07:01 niloysikdar

Hey @niloysikdar so I am done with the setup and docusaurus app running on my local device. I would like to ask about any good first issues which I can work on.

p.s. I am very new to open source. kindly bear with me 😅

Anurag2293 avatar Jan 23 '23 14:01 Anurag2293

Awesome @Anurag2293, you can explore the Beginner Friendly issues here

Do let me know if you need any more help.

niloysikdar avatar Jan 23 '23 14:01 niloysikdar

Hey @niloysikdar, after going through the first issues, I think I need to learn typescript for react (currently using plain JS only). I will get back to you after learning React with TS in 1-2 days.

Anurag2293 avatar Jan 24 '23 11:01 Anurag2293

Yes, you need to have the idea of TypeScrpt. Go ahead, all the best.

niloysikdar avatar Jan 24 '23 11:01 niloysikdar