From cf90a6d6377aaadb1ccac8079200d69101839a7b Mon Sep 17 00:00:00 2001 From: Tosin Akinosho Date: Mon, 18 Mar 2024 16:49:34 -0400 Subject: [PATCH] updating documentaion --- docs/index.markdown | 44 +++++++++++++++++++++++++++++++++++++++----- 1 file changed, 39 insertions(+), 5 deletions(-) diff --git a/docs/index.markdown b/docs/index.markdown index 6e3819d..ef12988 100644 --- a/docs/index.markdown +++ b/docs/index.markdown @@ -5,19 +5,53 @@ title: edge-anomaly-detection This repository contains the code for a workshop on how to use different tools to monitor and manage an edge-anomaly-detection application. The workshop covers the following topics: +- Deployment instructions +- Developer Deployment Instructions +- Viewing the Kafka messages under the data lake project +- Checking the Prometheus charts for the application +- Configuring Camel K Ship integration +## Project Overview and Purpose -# Deployment instructions +The purpose of this project is to provide a hands-on tutorial and example code for implementing anomaly detection on edge devices. Anomaly detection is a critical capability for IoT and edge computing applications, enabling devices to identify unusual behavior or failures in real-time. + +This repository includes code and notebooks to train anomaly detection models using machine learning, optimize and package the models for deployment on edge devices, and integrate the models with an IoT application using tools like Apache Kafka and Prometheus for monitoring. + +By working through this workshop, developers will gain practical experience with the end-to-end process of building and deploying an edge anomaly detection application, from data collection and model training to edge deployment and monitoring. + + +## Deployment instructions [Developer Deployment Instructions](deployment/developer_deployment/) -# WorkShop +## WorkShop * [Viewing the Kafka messages under the data lake project](workshop/check-kafka-messages/) * [Checking the Prometheus charts for the application](workshop/check-promethous-charts/) * [Configuring Camel K Ship integration](workshop/configure-camel-k/) -# Notebooks +## Notebooks * [Configure Red Hat OpenShift Data Science](notebooks/configure_rhods/) * [Train Tonnage Anomaly Detection](notebooks/train_tonnage_anomaly_detection/) -# Contributing -* [Developer Documentation for Setup Bastion Contribution](deployment/setup-bastion-doc/) + +## Contributing + +We welcome contributions to improve and expand this workshop! Here are a few ways you can contribute: + +- Report bugs, suggest enhancements, or ask questions by opening an issue on the [GitHub repository](https://github.com/tosin2013/edge-anomaly-detection/issues). +- Submit pull requests to fix bugs, add new features, or improve the documentation. +- Share your experiences, insights, or alternative approaches by writing blog posts or tutorials that reference this workshop. + +To contribute code changes, please follow these steps: + +1. Fork the repository on GitHub. +2. Create a new branch for your changes. +3. Make your changes and commit them with descriptive commit messages. +4. Push your changes to your forked repository. +5. Open a pull request to the main repository, describing your changes in detail. + + +## Additional Resources + +- [edge-anomaly-detection-notebooks](https://github.com/tosin2013/edge-anomaly-detection-notebooks): Jupyter notebooks with code examples and tutorials related to this workshop. +- [opcua-asyncio-build-pipelines](https://github.com/tosin2013/opcua-asyncio-build-pipelines/tree/main): Build pipelines for OPC UA applications using asyncio. +- [Example App](https://github.com/tosin2013/opcua-asyncio-build-pipelines/blob/main/complete-builds/engine-room-monitoring/engine-room-monitoring.py): A sample application demonstrating engine room monitoring using OPC UA and asyncio. \ No newline at end of file