Skip to content

Commit 5f10d7c

Browse files
Reformat the release notes
This makes it a bit more copy-paste friendly when creating the github release. Signed-off-by: Tiyash Basu <[email protected]>
1 parent 0e45c6d commit 5f10d7c

File tree

1 file changed

+42
-43
lines changed

1 file changed

+42
-43
lines changed

RELEASE_NOTES.md

Lines changed: 42 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -8,50 +8,49 @@
88

99
- Removed:
1010

11-
+ `microgrid.components.ComponentStatus`, use `microgrid.electrical_components.ElectricalComponentControlMode` instead
12-
+ `ComponentErrorCode.UNDERVOLTAGE_SHUTDOWN`, use `ElectricalComponentDiagnosticCode.UNDERVOLTAGE` instead
13-
+ `microgrid.sensors.SensorMetric`, use `metrics.Metric` instead
14-
+ `microgrid.sensors.SensorMetricSample`, use `metrics.MetricSample` instead
15-
+ `microgrid.sensors.SensorCategory`, since it was not useful and potentially confusing
16-
17-
Sensors can report different sensor metrics, and they could belong to several of these categories simultaneously. This defeats the purpose of having singular categories for sensors. Some more useful categorization may be introduced again in the future.
11+
- `microgrid.components.ComponentStatus`, use `microgrid.electrical_components.ElectricalComponentControlMode` instead
12+
- `ComponentErrorCode.UNDERVOLTAGE_SHUTDOWN`, use `ElectricalComponentDiagnosticCode.UNDERVOLTAGE` instead
13+
- `microgrid.sensors.SensorMetric`, use `metrics.Metric` instead
14+
- `microgrid.sensors.SensorMetricSample`, use `metrics.MetricSample` instead
15+
- `microgrid.sensors.SensorCategory`, since it was not useful and potentially confusing.
16+
Sensors can report different sensor metrics, and they could belong to several of these categories simultaneously. This defeats the purpose of having singular categories for sensors. Some more useful categorization may be introduced again in the future.
1817

1918
- Renamed several symbols to increase consistency and clarity:
2019

21-
+ `microgrid.components`:
20+
- `microgrid.components`:
2221

23-
* The whole package and all proto files, messages, field, enums were renamed to `electrical_components`
24-
* `ComponentCategoryMetadataVariant` to `ElectricalComponentCategorySpecificInfo`
25-
* `Component.category_type` to `ElectricalComponent.category_specific_info`
26-
* `ComponentCategoryMetadataVariant.metadata` to `ElectricalComponentCategorySpecificInfo.kind`
27-
* `ComponentErrorCode` to `ElectricalComponentDiagnosticCode`
28-
* `ComponentState` to `ElectricalComponentStateSnapshot`
29-
* `ComponentState.sampled_at` to `ElectricalComponentStateSnapshot.origin_time`
30-
* `ComponentData` to `ElectricalComponentTelemetry` (to better specify its purpose of encapsulating general telemetry data from electrical components)
31-
* Grid-related terms to clarify their meaning and purpose:
22+
- The whole package and all proto files, messages, field, enums were renamed to `electrical_components`
23+
- `ComponentCategoryMetadataVariant` to `ElectricalComponentCategorySpecificInfo`
24+
- `Component.category_type` to `ElectricalComponent.category_specific_info`
25+
- `ComponentCategoryMetadataVariant.metadata` to `ElectricalComponentCategorySpecificInfo.kind`
26+
- `ComponentErrorCode` to `ElectricalComponentDiagnosticCode`
27+
- `ComponentState` to `ElectricalComponentStateSnapshot`
28+
- `ComponentState.sampled_at` to `ElectricalComponentStateSnapshot.origin_time`
29+
- `ComponentData` to `ElectricalComponentTelemetry` (to better specify its purpose of encapsulating general telemetry data from electrical components)
30+
- Grid-related terms to clarify their meaning and purpose:
3231

33-
+ `COMPONENT_CATEGORY_GRID` to `ELECTRICAL_COMPONENT_CATEGORY_GRID_CONNECTION_POINT`
34-
+ `ComponentCategoryMetadataVariant.metadata.grid` to `ElectricalComponentCategorySpecificInfo.kind.grid_connection_point`
32+
- `COMPONENT_CATEGORY_GRID` to `ELECTRICAL_COMPONENT_CATEGORY_GRID_CONNECTION_POINT`
33+
- `ComponentCategoryMetadataVariant.metadata.grid` to `ElectricalComponentCategorySpecificInfo.kind.grid_connection_point`
3534

36-
+ `microgrid.sensors`:
35+
- `microgrid.sensors`:
3736

38-
* `SensorErrorCode` to `SensorDiagnosticCode`
39-
* `SensorData` to `SensorTelemetry` (to better specify its purpose of encapsulating general telemetry data from sensors)
40-
* `SensorState` to `SensorStateSnapshot`
41-
* `SensorState.sampled_at` to `SensorStateSnapshot.origin_time`
42-
* `SensorStateCode.SENSOR_STATE_CODE_ON` to `SensorStateCode.SENSOR_STATE_CODE_OK` (to better indicate that we do not control on/off state of sensors)
37+
- `SensorErrorCode` to `SensorDiagnosticCode`
38+
- `SensorData` to `SensorTelemetry` (to better specify its purpose of encapsulating general telemetry data from sensors)
39+
- `SensorState` to `SensorStateSnapshot`
40+
- `SensorState.sampled_at` to `SensorStateSnapshot.origin_time`
41+
- `SensorStateCode.SENSOR_STATE_CODE_ON` to `SensorStateCode.SENSOR_STATE_CODE_OK` (to better indicate that we do not control on/off state of sensors)
4342

44-
+ `metrics`:
43+
- `metrics`:
4544

46-
* The file `metric_sample.proto` to `metrics.proto`
47-
* `MetricSample.source` to `MetricSample.connection`
48-
* `MetricSample.sampled_at` to `sample_time`
45+
- The file `metric_sample.proto` to `metrics.proto`
46+
- `MetricSample.source` to `MetricSample.connection`
47+
- `MetricSample.sampled_at` to `sample_time`
4948

5049
- Renumbered some enum values to remove unnecessary gaps:
5150

52-
+ `microgrid.components.ComponentCategory` (`microgrid.electrical_components.ElectricalComponentCategory`)
53-
+ `microgrid.components.ComponentErrorCode` (`microgrid.electrical_components.ElectricalComponentDiagnosticCode`)
54-
+ `metrics.Metric`
51+
- `microgrid.components.ComponentCategory` (`microgrid.electrical_components.ElectricalComponentCategory`)
52+
- `microgrid.components.ComponentErrorCode` (`microgrid.electrical_components.ElectricalComponentDiagnosticCode`)
53+
- `metrics.Metric`
5554

5655
- The minimum allowed version of `protobuf` and `grpcio` has been updated to 6.31.1 and 1.72.1 respectively, you might also need to bump your dependencies accordingly.
5756

@@ -61,30 +60,30 @@ Added many new messages and enum values:
6160

6261
- `microgrid.communication_components`: Package with message definitions for communication components
6362

64-
+ `CommunicationComponentDiagnostic`: Message to represent warnings and errors in microgrid communication components
65-
+ `CommunicationComponentStateSnapshot`: Message to represent the state of communication components
63+
- `CommunicationComponentDiagnostic`: Message to represent warnings and errors in microgrid communication components
64+
- `CommunicationComponentStateSnapshot`: Message to represent the state of communication components
6665

6766
- `microgrid.electrical_components` (previously `microgrid.components`)
6867

69-
+ `ElectricalComponentDiagnostic`: Message to represent warnings and errors in microgrid electrical components
70-
+ `ElectricalComponentDiagnosticCode` (previously `ComponentErrorCode`): New diagnostic codes to cover more cases, especially for inverters
71-
+ `InverterType.INVERTER_TYPE_WIND_TURBINE`: Enum value to represent wind turbine inverters
68+
- `ElectricalComponentDiagnostic`: Message to represent warnings and errors in microgrid electrical components
69+
- `ElectricalComponentDiagnosticCode` (previously `ComponentErrorCode`): New diagnostic codes to cover more cases, especially for inverters
70+
- `InverterType.INVERTER_TYPE_WIND_TURBINE`: Enum value to represent wind turbine inverters
7271

7372
- `microgrid.sensors`
7473

75-
+ Message linking microgrid and sensor IDs
76-
+ `SensorDiagnostic`: Message to represent warnings and errors in microgrid sensors
77-
+ Added warnings to sensor `SensorState`
74+
- Message linking microgrid and sensor IDs
75+
- `SensorDiagnostic`: Message to represent warnings and errors in microgrid sensors
76+
- Added warnings to sensor `SensorState`
7877

7978
- `streaming`: Package with message definitions for streaming events
8079

81-
+ `Event`: Enum to represent different types of streaming events (Created, Deleted, Updated)
80+
- `Event`: Enum to represent different types of streaming events (Created, Deleted, Updated)
8281

8382
- `types`
8483

85-
+ `TimeIntervalFilter`: Message to standardize time interval filtering across APIs
84+
- `TimeIntervalFilter`: Message to standardize time interval filtering across APIs
8685

87-
This uses `start_time` (inclusive) and `end_time` (exclusive) fields, aligning with ISO 8601 and common programming conventions.
86+
This uses `start_time` (inclusive) and `end_time` (exclusive) fields, aligning with ISO 8601 and common programming conventions.
8887

8988
## Bug Fixes
9089

0 commit comments

Comments
 (0)