diff --git a/README.md b/README.md index 833ff0cf4..e59c356e8 100644 --- a/README.md +++ b/README.md @@ -60,14 +60,14 @@ Please join us on the following channels: ## Features | **Feature** | **Description** | **Status** | |------------------|-------------------------------------------------------|-----------------| -| Home Screen | Show status and version of PSLab device | ✓ | -| Instruments | Exposes PSLab instruments like Oscilloscope, etc | ✓ | -| Oscilloscope | Shows variation of analog signals | ✓ | -| Multimeter | Measures voltage, current, resistance and capacitance | ✓ | -| Logical Analyzer | Captures and displays signals from digital system | ✓ | -| Wave Generator | Generates arbitrary analog and digital waveforms | ✓ | -| Power Source | Generates programmable voltage and currents | ✓ | -| Lux Meter | Measures the ambient light intensity | ✓ | +| Home Screen | Show status and version of PSLab device | ✓ | +| Instruments | Exposes PSLab instruments like Oscilloscope, etc | ✓ | +| Oscilloscope | Shows variation of analog signals | ✓ | +| Multimeter | Measures voltage, current, resistance and capacitance | ✓ | +| Logical Analyzer | Captures and displays signals from digital system | ✓ | +| Wave Generator | Generates arbitrary analog and digital waveforms | ✓ | +| Power Source | Generates programmable voltage and currents | ✓ | +| Lux Meter | Measures the ambient light intensity | ✓ | ## How to set up the Android app in your development environment @@ -122,6 +122,39 @@ Please help us follow the best practice to make it easy for the reviewer as well * The pull request will not get merged until and unless the commits are squashed. In case there are multiple commits on the PR, the commit author needs to squash them and not the maintainers cherrypicking and merging squashes. * If the PR is related to any front end change, please attach relevant screenshots in the pull request description. +#### How to `git squash`? + +As a tip for new developers those who struggle with squashing commits into one, multiple commits may appear in your pull request mostly due to following reasons. + + * Intentionally adding multiple commit messages after each change without just `git add`ing. + * Updating the current branch with the remote so a merge commit takes place. + +Despite any reason, follow the steps given below to squash all commits into one adhering to our best practices. + + * Setup remote to upstream branch if not set before; + +`$ git remote add upstream https://github.com/fossasia/pslab-android.git` + + * Check into the branch related to the pull request + +`$ git checkout ` + + * Perform a soft reset to retain the changes while removing all the commit details + +`$ git reset --soft upstream/development` + + * Add files to the staging area + +`$ git add ` + + * Create a new commit with a proper message following commit message guidelines + +`$ git commit -m "tag: commit message"` + + * If you have already made a pull request, + +`$ git push -f origin ` + ### Branch Policy We have the following branches