Skip to content

Latest commit

 

History

History
80 lines (48 loc) · 4.92 KB

CONTRIBUTING.md

File metadata and controls

80 lines (48 loc) · 4.92 KB

Contributing to Searchit

👍🎉 First off, thanks for taking the time to contribute! 🎉👍

The following is a set of guidelines for contributing to Searchit, which are hosted on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.

How Can I Contribute?

How Can I Contribute?

Reporting Bugs

This section guides you through submitting a bug report for Searchit. Following these guidelines helps maintainers and the community understand your report 📝, reproduce the behavior 💻 💻, and find related reports 🔎.

Please make sure your copy of the software is up-to-date.

When you are creating a bug report, please include as many details as possible.

Note: If you find a Closed issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.

How Do I Submit A (Good) Bug Report?

Bugs are tracked as GitHub issues. Explain the problem and include additional details to help maintainers reproduce the problem:

  • Use a clear and descriptive title for the issue to identify the problem.
  • Describe the exact steps which reproduce the problem in as many details as possible.
  • Provide specific examples to demonstrate the steps. Include links to files or GitHub projects, or copy/pasteable snippets, which you use in those examples. If you're providing snippets in the issue, use Markdown code blocks.
  • Include screenshots For describing a bug properly you can provide screenshots of the situation.
  • Include Your Operating System Information. Which distribution of linux you are using. Version of that distribution.

Providing Suggestion And Ideas

You can provide new ideas and suggestions for future update. Your ideas and suggestions are always valuable to the community. And via contributing you became a member of this community too.

  • Suggest new web sites. As you know Searchit brings support for many web sites. A lot of the web sites have search features and many of them are pretty useful. If you think that a web site should be included, then let me know. I will review the website and probably will include supports for the site in our next update. Just make sure two things:

    • The website is Not An Adult Only Website
    • General/Group of People use the website often.
  • Suggest New Features. If you think there is a feature I could add in this software feel free to share with us. Maybe your brilliant idea will be the next goal for us.

    • Make sure your idea is related to this software
    • And let us know how your idea/feature can help you and others

Developing

If you understand how this software works, you can contribute as a developer. Hence I'm single-handedly developing this software, your skills of developing can help me a lot.

  • You can provide solutions for open issues.
  • Or you can pick a issue and contribute the changes needed to solve the issue.

Either way you are doing a great job and I appreciate that.

Rolling Release

Searchit is a "Rolling Release" Software. It means Searchit will recive updates as soon as it has new updates or bugfix or any other minor changes. Searchit's version system work like this v(Major Changes).(Bugfix/NewFeature).(Minor Changes) Ex: v2.3.1

Minor Changes counts as usual. But everything time a Bugfix/Feature update comes Minor Changes number gets a refresh. Similarly When a Major Change comes both Bugfix/Feature and Minor Changes number gets a refresvh. And from now all issues and pull request goest to the project board Heads Will Roll

Promoting

As you already know I'm the only one behind the whole thing and I am a regular teenage college student. For me promoting Searchit is quit a bit heavy task. I don't even know that much people. So if you let your friends know about this software or post it about in social media or any other work what can help this software to reach more people then it will help a lot. A lot means Actually A lot.

Last but not least thanks a lot again for doing your part. Even if you are unable to do any of this contribution that's ok. Even if you just use this software I will consider my self successful. Which is very helpful for my mental health. Thank you again.

                                - Somoy (Author)
                                
                                Copyright © 2020 Black Pearl Tech