Skip to content

Latest commit

 

History

History
177 lines (126 loc) · 6.7 KB

File metadata and controls

177 lines (126 loc) · 6.7 KB

Contributing Guide

Thanks for your interest in contributing to fullstack-singer-platform 🎉 We welcome issues, feature requests, bug reports, and pull requests.

Table of Contents

📜 Code of Conduct

Please read and follow our CODE_OF_CONDUCT.md.

🧭 Getting Started

  • 💬 Join the Discussions: Share your insights, provide feedback, or ask questions about Vevox.
  • 🐛 Report Issues: Submit bugs found or log feature requests for the fullstack-singer-platform project.
  • 💡 Submit Pull Requests: Review open PRs, and submit your own PRs.

🗂️ Full Stack Singer Platform — Community & Issue Hub

This project welcomes community feedback and feature suggestions.

🎯 Purpose

This repository serves as a community space to:

  • Report bugs and unexpected behaviours in article server
  • Request new features or improvements
  • Propose integrations or ideas for extending Full Stack Singer Platform (for example: MCP-style adapters, plugins, or example integrations)
  • Track the status of reported issues and feature requests

🛠️ How to Contribute

🐞 Reporting an Issue

  1. Open the Bug Report form: Create a Bug Report
  2. Choose the appropriate template (Bug Report or Feature Request)
  3. Provide as much detail as possible:
    • Steps to reproduce
    • Expected behaviour
    • Actual behaviour
    • Relevant logs or screenshots
    • System information (Node.js version, OS, browser)

✨ Requesting a New Feature

  1. Open the Feature Request form: Create a Feature Request
  2. Use the Feature Request template
  3. Describe clearly:
    • The feature you'd like to see
    • Why it would be valuable for full stack singer platform users
    • Any design/implementation ideas or trade-offs

🔌 Proposing an Integration or Extension

  1. Open a new issue and use the available template
  2. Include:
    • Name and short description of the integration
    • Use cases and benefits
    • Sample implementation or code snippets (optional)
    • References to similar tools or standards

🏷️ Issue Status & Labels

We use labels to indicate issue state. Common labels include:

  • triage — Under initial review
  • accepted — Approved for implementation
  • in-progress — Work is currently being done
  • needs-more-info — Additional information required from the reporter

🙌 Contributing Guide

Thanks for considering contributing to the Full Stack Singer Platfrom! Below is a short, friendly guide to make it easy for first-time contributors.

📚 What You Can Contribute

  • Improve documentation or fix typos
  • Suggest or add useful scripts, tools, or configurations (build scripts, example clients)
  • Add UI/UX improvements to the chat frontend
  • Report bugs or suggest new features
  • Add sample integrations or adapters (e.g., connecting Article Platform to other platforms)
  • Add tests or improve existing test coverage

⚡ Quick Contribution Steps

  1. Fork the Repository: Start by forking the project repository to your github account.
  2. Clone Locally: Clone the forked repository to your local machine using a git client.
    git clone https://github.com/MA1002643/fullstack-singer-platform
  3. Create a New Branch: Always work on a new branch, giving it a descriptive name.
    git checkout -b new-feature-x
  4. Make Your Changes: Develop and test your changes locally.
  5. Commit Your Changes: Commit with a clear message describing your updates.
    git commit -m 'Implemented new feature x.'
  6. Push to github: Push the changes to your forked repository.
    git push origin new-feature-x
  7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
  8. Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!

✅ Contribution Guidelines & Best Practices

  • Keep code readable and follow existing project style
  • Add tests for new behaviour where possible
  • Link any third-party resources you include
  • Use meaningful commit messages and keep commits focused
  • Be responsive to review feedback and update your PR when requested

📝 Credit & License

  • All contributions will be credited in the Contributors section.
  • By contributing, you agree that your changes will be licensed under the project's MIT License.

❓ Questions or Feedback

  • If you're unsure where to start, open an issue labelled good-first-issue or ask in Discussions.
  • For direct questions about contributing workflows, open an issue and tag the maintainer.

© 2025 Muhammad Abdullah
Developed with 💙 using HTML, CSS, JavaScript
Back to Top