Usage.md

 # Usage — Linux-Epoll
 
-## Usage
+## Requirements
 
-Understand the [native API](http://man7.org/linux/man-pages/man7/epoll.7.html).
+- Java 11 or later (Java 17 recommended for swarm/IoT variants)
+- Apache Maven 3.6+
+- Network access to the NOVA SYS Maven repository (if using pre-built artifacts)
 
-Read the
-[javadoc](https://javadoc.io/doc/io.helins/linux-epoll).
\ No newline at end of file
+## Installation
+
+_See the project README and pom.xml for build instructions._
+
+## Configuration
+
+_This project has no configuration parameters._
+
+See the [Configuration](configuration) page for a complete parameter reference.
+
+## Integration Example
+
+```java
+Properties props = new Properties();
+try (InputStream in = new FileInputStream("config.properties")) {
+    props.load(in);
+}
+
+Host myself = new Host(InetAddress.getLocalHost(), Integer.parseInt(props.getProperty("port", "8000")));
+
+Babel babel = Babel.getInstance();
+babel.registerProtocol(new LinuxEpoll(props, myself));
+babel.start(props);
+```
+
+## Running
+
+```bash
+# Build
+mvn clean package -DskipTests
+
+# Run (adjust main class and config path)
+java -cp target/*.jar MainClass config.properties
+```
+
+## Further Reading
+
+- [Babel Interface](babel-interface) — how to subscribe to this protocol's notifications
+- [Configuration](configuration) — full parameter reference
+
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE) — see the `LICENSE` file
+in the repository for the full text.
+
+Copyright © 2021–2026 [Computer Systems Group, NOVA LINCS](https://novasys.di.fct.unl.pt/)
+at [FCT-UNL](https://www.fct.unl.pt/).
+Developed in the context of the [TaRDIS](https://project-tardis.eu/) European Project
+(EU Horizon 2020, Grant Agreement No. 101016175).
+Also see: [NOVA LINCS](https://nova-lincs.di.fct.unl.pt/) |
+[TaRDIS on CORDIS](https://cordis.europa.eu/project/id/101016175)