Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/simonthorell/wl-iot-protocols-report
Report comparing various wireless protocols used in IoT
https://github.com/simonthorell/wl-iot-protocols-report
github-actions-ci iot wireless-protocol
Last synced: 8 days ago
JSON representation
Report comparing various wireless protocols used in IoT
- Host: GitHub
- URL: https://github.com/simonthorell/wl-iot-protocols-report
- Owner: simonthorell
- Created: 2024-02-07T13:23:04.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-02-09T15:11:20.000Z (9 months ago)
- Last Synced: 2024-08-09T11:23:40.511Z (3 months ago)
- Topics: github-actions-ci, iot, wireless-protocol
- Language: Python
- Homepage:
- Size: 1.99 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Wireless IoT Protocol Report
This repository is designed to facilitate collaborative work on a comprehensive report about Wireless IoT Protocols using markdown formatting. It leverages a Continuous Integration (CI) pipeline, which utilizes Python scripts to automatically merge markdown files into a single document and generate illustrative diagrams using matplotlib. Once a pull request is made to the main branch, the pipeline also compiles these materials into a PDF document.
## Usage Instructions
### Setting Up and Making Changes
1. **Clone the Repository:**
Clone the repository to your local machine to start working on the report.
```
git clone https://github.com/simonthorell/wl-iot-protocols-report.git
cd wl-iot-protocols-report
```
2. **Create a New Branch:**
Work on a new branch to encapsulate your changes.
```
git checkout -b
```
Replace `` with your desired branch name.
3. **Edit the Markdown Files:**
Make your contributions by editing or adding markdown files within the `protocols` folder.
4. **Update Your Branch:**
Before finalizing your changes, ensure your branch is updated with the latest main branch content.
```
git pull origin main
```
5. **Commit Your Changes:**
Add and commit the changes you've made to your branch.
```
git add protocols/.md
git commit -m ""
git push --set-upstream origin
```
### Creating and Merging Pull Requests
6. **Open a Pull Request on GitHub:**
Navigate to the [repository on GitHub](https://github.com/simonthorell/wl-iot-protocols-report), switch to the `Pull requests` tab, and create a new pull request from your branch to the main branch.
7. **CI Pipeline Execution:**
The CI pipeline will automatically execute Python scripts to merge all markdown files into a comprehensive `REPORT.md` and use another script to create necessary diagrams. Subsequently, it will compile these into a `REPORT.pdf` in the `pdfs` folder.
### Important Note for Merging
- **Review Requirement:**
Your pull request may require review. Ensure that it is reviewed by a team member or a repository administrator before proceeding. You can request a review through the GitHub interface.
- **CI Completion:**
Due to a GitHub Actions/Workflows limitation, wait for all CI pipeline jobs to complete successfully before merging your pull request into the main branch. Merging prematurely might result in your changes not being correctly reflected in the master files.
- **Squash Merging Pulll Requests:**
To keep commit history clean in the main branch, all commits from the feature branched will be squashed to a `single commit message` in main using the `pull request title`.