Skip to content

Latest commit

 

History

History
182 lines (108 loc) · 4.64 KB

CONTRIBUTING.md

File metadata and controls

182 lines (108 loc) · 4.64 KB
Raw

CONTRIBUTING

Introduction

Hello and thank you for your interest in contributing to Activity Tracker.

Contributions are welcome and there are many ways you can get involved!

To get started, choose your area of interest:

👥 Issues & Discussions | 📚 Documentation | 📣 Spread the word | 💻 Code Contribution

👥 Issues & Discussions

You can interact with users by sharing information and asking/answering questions in our Discussions tab.

Also, you can contribute by reporting bugs, patching problems or providing technical support in our Issues tab.


📚 Documentation

Documentation is key for any project success!

Currently, our documentation is stored at the README file of this repository.

You may contribute by improving existing information, covering missing topics, or fixing typos and grammar errors.

The documentation official language is in English.


📣 Spread the word

If you enjoy Activity Tracker, please consider talking about our project in your community.

Share this repository link on Twitter, YouTube, Discord or any other social network you are part of.

You are also welcome to write articles, reviews and tutorials about this project on your blog or programming website.

Ah! Don't forget to let the author know about your work. Say hello to @SaptarshiDy.


💻 Code Contribution

Please follow the steps below to contribute with code.

Steps

📌 Step 1

Fork this repository and enter its directory.

Replace the placeholder <YOUR-USERNAME> with your GitHub username and run the command:

git clone https://github.com/<YOUR-USERNAME>/activity-tracker.git && cd activity-tracker

📌 Step 2

Install all PHP dependencies using Composer, run the command:

composer install

Once finished, proceed to install Node dependencies. Run the command:

npm install

📌 Step 3

Create a new branch for your code. You may call it feature- / fix- / enhancement- followed by the name of what you are developing.

For example:

git checkout -b feature/feature-new_about_page

Now, you can work on this newly created branch.

📌 Step 4

If you're working on the front-end of Activity Tracker, you want to run the command npm run watch to automatically rebuild any CSS and JavaScript files.

Keep in mind that any front-end changes will need to be re-published to your Laravel application:

php artisan activity-tracker:publish

The command also takes an additional parameter, --watch which continuously watches for new front-end changes and re-publishes them.

php artisan activity-tracker:publish --watch

📌 Step 5

You may want to install your modified version of Activity Tracker inside a Laravel application, and test if it performs as expected.

In your Laravel application, modify the composer.json adding a repositories key with the path of Database-Viewer on your machine.

This will instruct composer to install Activity Tracker from your local folder instead of using the version on the official repository.

Example:

// File: composer.json

{
  "scripts": { ... },

  "repositories": [
    {
      "type": "path",
      "url": "/home/myuser/projects/activity-tracker"

    }
  ]
}

Proceed with composer require next-build/activity-tracker.

📌 Step 7

If you changed any CSS or JavaScript files, you must build the assets for production before committing.

Run the command:

npm run production

📌 Step 8

Commit your changes. Please send short and descriptive commits.

For example:

git commit -m "adds route for about page"

📌 Step 9

If all tests are ✅ passing, you may push your code and submit a Pull Request.

Please write a summary of your contribution, detailing what you are changing/fixing/proposing.

When necessary, please provide usage examples, code snippets and screenshots. You may also include links related to Issues or other Pull Requests.

Once submitted, your Pull Request will be marked for review and people will send questions, comments and eventually request changes.

🙏 Thank you for your contribution!