====== AOFS Change Log & Versioning ======

This page documents all major and minor revisions to the **Afritic Open Farming Standard (AOFS)**, including updates to modules, controllers, sensors, and operational logic.  
Each entry includes the version number, release date, and a brief summary of changes.

===== Versioning Scheme =====
AOFS uses [[https://semver.org|Semantic Versioning]] principles:

  * **MAJOR** – Significant changes, backward-incompatible updates, or new core features.
  * **MINOR** – Backward-compatible additions or improvements to modules or controllers.
  * **PATCH** – Bug fixes, clarifications, or minor corrections in documentation or reference implementations.

**Example:**  
  * Version `2.3.1` → Major version 2, minor update 3, patch 1.

===== Change Log EXAMPLE =====
  * **v1.0.0 (2026-01-21)** – Initial public release of AOFS.
    * Defined core principles, system architecture, and sensor categories.
    * Published reference implementations for Field Controller Layer.
    * Introduced Hydraulic, Electrical, and Actuation modules.
    * Created Glossary, Terminology, and Scope sections.

  * **v1.1.0 (2026-02-10)** – Added optional modules and energy-aware scheduling.
    * Introduced Poultry Farming Module.
    * Added Energy Monitoring and Event Prioritization features to Electrical Module.
    * Updated Sensors Layer with Human Input / External Event Logging.
    * Added Weather Sensors and Optical Monitoring improvements.

  * **v1.1.1 (2026-02-18)** – Patch release.
    * Corrected DokuWiki syntax in sensors:start and electrical:start pages.
    * Updated glossary links and added missing references.
    * Fixed minor typos in Scope and Documentation Structure.

  * **v1.2.0 (2026-03-05)** – Expanded modular architecture.
    * Added Livestock / Animal Husbandry Module.
    * Updated guidelines for optional Greenhouse / Hydroponics Module.
    * Defined interface for third-party custom modules.
    * Clarified optional solar integration and power-aware operation rules.

===== Notes =====
  * All AOFS modules, pages, and reference implementations **must include the version number** for traceability.
  * Patch releases should be documented even if changes are minor, for auditing and compliance.
  * This change log is **extendable** and should be updated whenever new features, corrections, or modules are added.

===== Recommended Practice =====
  * Each AOFS deployment should **document the AOFS version in use** for all controllers and modules.
  * All local changes, extensions, or custom modules should also include a **version note referencing the main AOFS release**.