Skip to content

Enhance README Documentation for React Developer Community Kenya Website #147

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: prod
Choose a base branch
from

Conversation

festus-sulumeti
Copy link

This PR updates the README.md file to provide a more detailed and structured documentation for the project. The goal is to improve onboarding for new contributors, provide clear project details, and make the repository more informative.

Changes Introduced

  • Added a Project Overview with goals and technologies used.
  • Included a Live Demo section with a link and potential screenshots/GIFs.
  • Organized a Table of Contents for easy navigation.
  • Expanded the Features list for better clarity.
  • Detailed Getting Started steps, including installation and running locally.
  • Enhanced Contributing Guidelines with step-by-step instructions.
  • Provided a Figma Design section with a reference link.
  • Added an FAQs section to address common questions.
  • Updated License information and provided a direct link.
  • Included Contact Information for community engagement.

Checklist

  • Ensure all sections are well-structured and easy to read.
  • Verify all links (live demo, Figma, contributing guide, etc.) are working correctly.
  • Confirm markdown formatting follows best practices.
  • Gather feedback from the community before merging.

###Related
Closes: #146

Copy link

vercel bot commented Mar 26, 2025

@festus-sulumeti is attempting to deploy a commit to the React Developers Kenya Team on Vercel.

A member of the Team first needs to authorize it.

@orama254
Copy link
Member

@festus-sulumeti, thanks for this contribution. as per the contribution guidelines, try make the pull request against the develop branch.


Contributions are always welcome!

See [`contributing.md`](https://github.com/reactdeveloperske/reactdevske-website/blob/main/CONTRIBUTING.md) for ways to get started.
### How to Contribute
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@festus-sulumeti

For the contribution guidelines section, emphasize on the detailed instructions that are available on the contribution guidelines. Some steps are missing from this summary which are very important and are addressed on the contribution guidelines,

- **Node.js**: Backend runtime.
- **Tailwind CSS**: Styling.
- **GitHub Actions**: CI/CD.
- **Netlify/Vercel**: Deployment.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Deployments are done on Vercel

## Figma design file
## Technologies Used

- **React.js**: Frontend framework.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add React,js as the frontend javascript library

## Technologies Used

- **React.js**: Frontend framework.
- **Node.js**: Backend runtime.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add Next.js as the Frontend React Framework.


### 2. How do I report a bug?

You can report bugs by creating an issue in the [GitHub Issues](https://github.com/reactdeveloperske/reactdevske-website/issues) section.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also add that one has to go through the contribution guidelines (add a markdown link) for guidance


### 3. Can I suggest new features?

Absolutely! Feel free to open a feature request in the [GitHub Issues](https://github.com/reactdeveloperske/reactdevske-website/issues) section.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also add that one has to go through the contribution guidelines (add a markdown link) for guidance

React Developers Kenya Community
Email: [[email protected]](mailto:[email protected])
Website: [reactdevske.org](https://www.reactdevske.org/)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

@orama254 orama254 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @festus-sulumeti

Thank's for your contribution, check out the comments added.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Create a Detailed README for React Developer Community Kenya Website
2 participants