Release notes

With every update we write release notes. This way you know what has been added or fixed. If you sign up, you will get a monthly overview in your inbox.

2.29.1

28 Feb 2023

Introducing 2FA

API andDashboard updated

⚡️ New features

  • Added 2FA support for dashboard accounts. Enable this by going to the security setting inside of ‘edit profile’.
  • Added application security details on the project overview.

🐞 Bug fixes

  • Fixed a bug when there were more than 10 applications, only the first 10 would be shown.

5.28.0

21 Feb 2023

Tile service bug

API updated

🐞 Bug fixes

  • Fixed a bug on the tile service where powerGroups[]=slow and power[]=350 did not filter the results.

5.27.3

21 Feb 2023

Tile service improvement

API updated

✨ Improvements

  • Improved the performance of the tile service for faster response times.

5.27.2

14 Feb 2023

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.27.1

09 Feb 2023

Bug fix stationList

API updated

🐞 Bug fixes

  • Fixed a bug where stationList queries returned an error when the searched string had 24 characters and was not a valid id.

5.27.0

07 Feb 2023

Tile service filter excluded operators

API updated

⚡️ New features

  • Added support for filtering out excluded operators on the tile service using the project configuration.

🐞 Bug fixes

  • Fixed a bug where entering the same location for a via and destination would end up in an error instead of calculating a route.
  • Fixed a bug where the deprecated tile service filter connectors[]=all was giving a response on lower zoom levels.

5.26.1

06 Feb 2023

Bug fixes

API updated

🐞 Bug fixes

  • Fixed a bug where adding additional cargo and/or occupants at a via were not correctly applied on the legs after the via.
  • Fixed a bug where missing country codes in our map data could lead to uncomputable routes.

5.26.0

01 Feb 2023

Bug fixes

API updated

🐞 Bug fixes

  • Fixed a bug where the operators sent on newRoute were not included on route.routeRequest.
  • Fixed a bug for the vehicle queries where the default battery capacity was using incorrect vehicle details resulting in an incorrect chargetrip_range.

5.25.1

30 Jan 2023

Chargetrip range bug fix

API updated

🐞 Bug fixes

  • Fixed a bug on vehicle.chargetrip_range, where updating a vehicle would cause the chargetrip_range to be incorrect.

5.25.0

26 Jan 2023

Dashboard update

Dashboard updated

✨ Improvements

  • Improved the vehicle selection list by adding tags for BEVs and PHEVs.

5.24.0

17 Jan 2023

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.23.1

16 Jan 2023

Dashboard updates

Dashboard updated

⚡️ New features

  • Added a complete redesign to the dashboard that matches the developer portal.
  • Added the ability to reset to default values when changing project configurations.
  • Added support for adding multiple iOS or android identifiers on application restrictions.
  • Added support for changing the best matching weight limits.

✨ Improvements

  • Improved analytics performance.
  • Improved the performance of rendering UI components.
  • Improved client and application safety by masking the keys by default.

📦 Deprecated

  • Deprecated the reports tab for an export functionality on analytics.

5.22.0

10 Jan 2023

Route mutation validation

API updated

✨ Improvements

  • Improved our error coverage on the route mutation validation by enforcing all errors. For an overview of all possible errors, please take a look here.

5.21.0

22 Dec 2022

Navigation update and bug fixes

API andDashboard updated

⚡️ New features

  • Added an acknowledgement scalar for successful responses on updateNavigation, recalculateNavigation and finishNavigation .

✨ Improvements

  • Improved memory usage by moving instructions formatting from Navigation  to startNavigation
  • Improved updateNavigation by changing speed on NavigationUpdateLocationPropertiesInput from type Float to type VehicleSpeed
  • Improved Telemetry by replacing BatteryInputType with StateOfChargeUnit .
  • Improved NavigationRecalculateInput by adding unit type StateOfChargeUnit .
  • Improved schema to correctly annotate non nullable fields within a navigation session.

🐞 Bug fixes

  • Fixed a bug where recalculate navigation would return an internal server error because of incorrect unit conversions.
  • Fixed a bug on the dashboard where only newly added models were saved when updating the vehicle list.

📦 Deprecated

  • Deprecated altitude in favor of elevation on updateNavigation.

5.20.2

16 Dec 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.20.1

15 Dec 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.20.0

14 Dec 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.19.0

12 Dec 2022

Introduction of Vehicle Database

API andDashboard updated

Warning

This release contains experimental features. They may change, break, or disappear at any time.

⚡️ New features

  • Added a complete new vehicle database that supports hybrid vehicles, commercial vehicles, country-level support and improved specifications. The vehicle database will replace the car database.

5.18.0

29 Nov 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.17.0

24 Nov 2022

Added additional telemetry fields on navigation

API updated

⚡️ New features

  • Added support for unit types. Telemetry data can be provided in both metric as well as imperial units. Example given, WeightUnit accepts total_cargo_weight and total_occupant_weight in kilograms and pounds.

✨ Improvements

  • Improved the navigation mutations by adding auxiliary_consumption, is_charging and total_cargo_weight to the telemetry field.

5.16.0

11 Nov 2022

Integer fix on connect

API updated

🐞 Bug fixes

  • Fixed a bug where an integer was expected but a float was received on battery.percentage on connectedVehicleData.

5.15.0

04 Nov 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.14.0

20 Oct 2022

Weather fix on isolines

API updated

🐞 Bug fixes

  • Fixed a bug on isolines where the weather scenarios were not considered.

5.13.0

17 Oct 2022

Round trip added to isolines

API updated

⚡️ New features

  • Added round_trip to isoline.

✨ Improvements

  • Improved ferries on isoline by adding FeatureLineString to ferry connections.

5.12.0

12 Oct 2022

Connect bug fixes and improvements

API updated

⚡️ New features

  • Added pagination to connectedVehicleList .

🐞 Bug fixes

  • Fixed a bug where null was accepted on the scope of createConnectedVehicle .
  • Fixed a bug where duplicate values were accepted on the scope of createConnectedVehicle .
  • Various small bug fixes.

5.11.0

06 Oct 2022

Station search using EVSE ID

API updated

⚡️ New features

  • Added support for search over EVSE IDs on the station query.

🐞 Bug fixes

  • Fixed a bug where some of the vehicle brand images had incorrect aspect ratios.
  • Fixed a bug where the tile service sometimes gave back a different station status than the API.

5.10.0

27 Sep 2022

Improved token management

Dashboard updated

✨ Improvements

  • Improved dashboard security by introducing better token management

5.9.0

27 Sep 2022

Introduction of amenity preferences

API updated

⚡️ New features

  • Added support for amenity_preferences. Within the new argument, scheduled_charge_stops is introduced, which can be used to schedule a stop with a specific duration, amenity types and distance between the amenities and station. all_charge_stops replaces amenities and can be found within the same argument.

📦 Deprecations

  • Deprecated amenities in favor of amenity_preferences. See deprecations for more information.

5.8.2

06 Sep 2022

Route steps bug fix

API updated

🐞 Bug fixes

  • Fixed a bug on Route Steps where some route steps had a negative duration.

5.8.1

02 Sep 2022

Station database bug fix

API updated

🐞 Bug fixes

  • Fixed a bug on the station import where a large number of stations with changed coordinates would cause the import to fail.

5.8.0

01 Sep 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

5.7.0

25 Aug 2022

Isoline bug fix

API updated

🐞 Bug fixes

  • Fixed a bug on isoline subscription where no update were send after the first two states.

5.6.1

24 Aug 2022

Tile service bug fix

API updated

🐞 Bug fixes

  • Fixed a bug on the tile service where the map focused on incorrect coordinates after breaking up a cluster.

5.6.0

18 Aug 2022

Bug fixes

API updated

🐞 Bug fixes

  • Fixed a bug where the SoC dropped after reaching a waypoint.
  • Fixed a bug where the value 0 was skipped for cargo.

5.5.0

16 Aug 2022

Introduction of connected car data platforms

API updated

⚡️ New features

  • Added support for connected car data platforms. For more information on vehicle connectivity please go here.

✨ Improvements

  • Improved the user authorization service for operations that require authorization (review module, connect) by replacing the x-token header with Authorization.

🐞 Bug fixes

  • Fixed a bug where stations with changing coordinates were not synchronised immediately after a station import.

5.4.0

08 Aug 2022

Introduction of crossborder

API updated

⚡️ New features

  • Added support for the crossborder route step to indicate when a route crosses a border.

🐞 Bug fixes

  • Various small bug fixes.

5.3.0

28 Jul 2022

Bug fixes

API updated

🐞 Bug fixes

  • Fixed a bug where we did not send a verification email after updating an account’s email address.
  • Changed locations_data to location_data on updateNavigation mutation.

5.2.0

27 Jul 2022

Schema update

API updated

🐞 Bug fixes

  • Fixed a bug where Isoline subscription was not shown in the schema

5.1.0

21 Jul 2022

API support isoline

API updated

⚡️ New features

  • Added support for the new query isoline that offers a graphical visualization of the range of a vehicle based on energy consumption

✨ Improvements

  • Improved schema descriptions for updateNavigation

🐞 Bug fixes

  • Fixed a bug with missing country codes on country_code GraphQL enum

5.0.0

14 Jul 2022

Stability

API updated

✨ Improvements

  • Improved stability by restructuring our backend services.

4.30.1

28 Jun 2022

Bug fix rangeStart alternative routes

API updated

🐞 Bug fixes

  • Fixed a bug where in some cases, the total load in the car was not taken into account when establishing the rangeStart of the alternative routes

4.17.0

10 Feb 2022

Eco-movement pricing module

API updated

⚡️ New features

  • Added support for the Eco-movement pricing module. All our customers using the pre integrated Eco-movement database, can use pricing instead of tariff on EVSEs. We recommend customers to switch to the new pricing query. See pricing for more information.
  • Added operatorName and operatorRanking on routeLeg

🐞 Bug fixes

  • Fixed a bug in stationStats on the stations count grouped by amenities.

4.16.0

03 Feb 2022

Added mapping for Mapbox navigation SDK

API updated

⚡️ New features

  • Added the new query navigationMapping that converts a route to navigation instructions for a specified mapping provider. Currently Mapbox is supported, other mapping providers will follow.
  • Added an all new dark and light mode to the dashboard.
  • Added date range inputfields to the dashboard calendar dropdown.
  • Added the ability to remove your account from the dashboard.
  • Added the ability to remove your own projects from the dashboard.

✨ Improvements

  • Improved stability by fixing various small bugs

4.15.0

26 Jan 2022

Added operator ranking to best matching alternative route

API updated

⚡️ New features

  • Added operator ranking to bestMatching type. The best matching route is now a combination of operator and amenity preferences.

4.14.0

19 Jan 2022

WebSocket Protocol

API updated

⚡️ New features

  • Added support for the graphql-transport-ws protocol on our WebSocket. Learn more.

📦 Deprecations

  • Deprecated passengers in favor of occupants. See deprecations for more information.

4.13.0

13 Jan 2022

State management

API updated

✨ Improvements

  • Improved state management on the dashboard to remember filter and search states while navigating through pages.
  • Improved the performance of fetching project details.

🐞 Bug fixes

  • Fixed a bug on the dashboard where you were not able to enter certain domains as HTTP referrer.
  • Fixed a bug on the dashboard where an empty graph would sometimes scale on Firefox.

4.12.0

11 Jan 2022

Stability

API updated

✨ Improvements

  • Improved stability by fixing various small bugs.

4.11.0

22 Dec 2021

Station import improvements

API updated

✨ Improvements

  • Improved the station import by comparing old and new station data before adding or removing stations from the database.

🐞 Bug fixes

  • Fixed a bug on alternative routes where an error message was thrown when tariffs were requested.

4.10.0

20 Dec 2021

Configurable prioritized operators in the dashboard

API andDashboard updated

⚡️ New features

  • Added the ability in the dashboard to prioritize operators on a project / x-client-id.

🐞 Bug fixes

  • Fixed a bug where the safeRiskMargin caused routes to fail when the SoC at origin was below the safeRiskMargin.

4.9.0

09 Dec 2021

Advanced project settings

API andDashboard updated

⚡️ New features

  • Added the ability to automatically add cars to a project / x-client-id. Note: when enabled only new cars will be added. Cars that are currently available and not attached to a client will not be added.
  • Added the ability to set charge mode on a project / x-client-id
  • Added the ability to set charge stop duration on a project / x-client-id

4.8.0

07 Dec 2021

Merge into master

API updated

⏭ Onto the next one

  • In this release we honor Jay-Z. No new features, improvements or fixes. We are on to the next one.

4.7.0

02 Dec 2021

Security

API andDashboard updated

⚡️ New features

  • Added the ability to restrict the use of client and application ids based on different security restrictions per platform. Read more here.
  • Added the ability to configure x-app-id security restrictions on the dashboard
  • Added the ability to customize the charge duration and charge mode on the x-client-id through the dashboard

4.6.0

18 Nov 2021

Under the hood

API updated

🛠 Refactoring

  • Some refactoring under the hood that needed to be launched.

4.5.0

17 Nov 2021

Range in percentages

API updated

⚡️ New features

  • Added the ability to query range in percentages on getRoute and use percentages as an input value. Please be aware when adding percentages for the state of charge and the final state of charge they are a percentage of the usableCarBattery or the capacity when including this object in the mutation.

✨ Improvements

  • Improved search and filtering on the operatorList query.

🐞 Bug fixes

  • Fixed an issue where rangeEnd and rangeEndKwh were 0 when plotting a route using a car that does not support fast charging.

4.4.0

11 Nov 2021

Error handling

API andDashboard updated

✨ Improvements

  • Improved error handling on the login section of the dashboard.

4.3.1

01 Nov 2021

Bug fix review module

API updated

🐞 Bug fixes

  • Fixed a bug where station.review.count and station.review.rating were not incremented when a review was added.

4.3.0

28 Oct 2021

Stability Improvements

API updated

✨ Improvements

  • Improved stability through several software updates.

4.1.0

21 Oct 2021

Route mutation validation

API updated

✨ Improvements

  • Improved error coverage for the route mutation validation. All errors are currently collected and used to improve the error messages. Routes will be returned for now, even if there are mistakes in the route mutation. We will notify you before enforcing the new errors.

🐞 Bug fixes

  • Fixed a bug where safeRiskMargin was applied twice in winter scenarios.

4.2.0

21 Oct 2021

Test merge into master

API updated

👉 My finger ... is on the button

4.0.0

13 Oct 2021

Stability improvements

API updated

✨ Improvements

  • Improved stability through several software updates.

3.33.0

30 Sep 2021

Bug fixes

API updated

🐞 Bug fixes

  • Fixed a bug where an incorrect start range when using OPTIMIZE_TRAVEL_TIME was displayed.

3.32.0

22 Sep 2021

Improved tile service expansion zoom

API updated

✨ Improvements

  • Improved tile service cluster break-up by adjusting the expansion zoom calculation.
  • Improved filtering of stations by excluding onboard chargers below 20 kW for all models with onboard capabilities higher than 20 kW.

🐞 Bug fixes

  • Fixed a bug where the routePath query changed the route path location search from a strict find to nearest point search.
  • Fixed a bug where list queries accepted negative integers.

3.31.0

15 Sep 2021

Tiered preferred operators and excluded operators

API andDashboard updated

⚡️ New features

  • Added the input argument operators to the newRoute mutation! We are happy to announce the release of a tiered preferred operator system and the ability to exclude operators from routing! From now on, in your route request, you will be able to add what operators you want us to prefer in order of ranking, and let us know if there are operators you wish to exclude from the route calculation! The same functionality is possible to include in the config of your client ID, which will soon be possible to adjust in the dashboard; get in touch with us directly until then.

3.30.0

01 Sep 2021

Improved Charge Time estimates

API updated

✨ Improvements

  • Improved charge time estimates by introducing a generalized charge curve model that accounts for the On Board Charging (OBC) power threshold and drop-off characteristic at higher state of charges. The generalized charge curve model is used for all cars for which we have sufficient data. We will increase our coverage over time when more data becomes available.

3.29.0

24 Aug 2021

E2E Maintenance

API updated

✨ Improvements

  • Improved release times by lowering the memory usage on our end to end tests.
  • Improved performance for several sections of the Chargetrip dashboard.

🐞 Bug fixes

  • Fixed an issue with the optimal route where in some cases a station was selected far from the optimal route.

3.28.0

18 Aug 2021

Introduction of chargeMode

API andDashboard updated

⚡️ New features

  • Added chargeMode. This field can be set to OPTIMIZE_TRAVEL_TIME and ALWAYS_TO_MAX_CHARGE.

3.27.0

17 Aug 2021

CI/CD Upgrade

API updated

✨ Improvements

  • Improved CI/CD for faster releases.

3.26.0

10 Aug 2021

Turn-by-turn instructions

API updated

⚡️ New features

  • Added 'raw' turn-by-turn instructions that can be used in combination with navigation SDK's to offer turn-by-turn navigation. To receive the instructions, add the instructions argument to the newRoute mutation. Don’t forget to also request the instructions in the getRoute request. Important: this feature is still in active development and it should only be used for test purposes until further notice.

✨ Improvements

  • Improved performance for several sections of the Chargetrip dashboard.

3.25.0

04 Aug 2021

Client configuration options

API updated

⚡️ New features

  • Added the field max_electric_power which gives the maximum electric power in kW of a connector/adapter. max_electric_power is exposed on the carList, Car and CarPremium query.
  • Added the ability to configure the time it takes to halt, start and stop charging on client level. We default to 5 minutes if you choose not to change this. This functionality will soon become available to you in the dashboard.

✨ Improvements

  • Improved the description of the power field for connectors and adapters to: "Usable electric power in kW".

🐞️ Bug fixes

  • Fixed an issue where the route mutation returned an internal server error when the operatorPrefer parameter was set to true and the operatorIds parameter set to null.
  • Fixed an issue where safeRiskMargin could be set to null. An integer between 0 and 60 is now required.

3.24.0

30 Jul 2021

Stability improvements

API updated

✨ Improvements

  • Improved stability through several software updates.

3.22.1

29 Jul 2021

Configurable charge speed

API andDashboard updated

⚡️ New features

  • Added configurable charge speed for our customers. By default we use the average charge speed, but customers can now choose to use the maximum charge speed instead. This functionality will soon become available to you in the dashboard.

🐞️ Bug fixes

  • Fixed an issue with the tariffs module where in some cases the wrong tariff was displayed.
  • Fixed an issue when the WebSocket broke and it didn’t return a result on a subscription by adding a KeepAlive message.

3.14.1-supercluster.15

22 Jul 2021

Tile service performance

API updated

✨ Improvements

  • Improved the performance of our Tile Service to provide more structured clustering and faster response times.

3.14.1

14 Jul 2021

Password changes

API updated

⚡️ New features

  • Added the ability to change your Chargetrip account password through your profile.

3.9.0

28 Jun 2021

Performance improvements

API andDashboard updated

✨ Improvements

  • Improved performance for several sections of the Chargetrip dashboard.

3.8.0

17 Jun 2021

pathPlot Release

API updated

⚡️ New features

  • Added the pathPlot property in favour of elevationPlot.
  • Added support to search the carList by id.

✨ Improvements

  • Improved how routes should be queried. A single additional route query is no longer needed after you started a route subscription.

🐞️ Bug fixes

  • Removed the unused operator and station subscriptions.
  • Fixed an issue where in some cases an incorrect connector type was selected at charge stations.

3.3.4

02 Jun 2021

Routing in Low Density Charge Station Regions

API updated

⚡️ New features

  • Added support for URL parameter authentication on top of header authentication to provide a more seamless Mapbox integration. See our updated documentation here.

✨ Improvements

  • Improved our calculations in regions where the density of stations is still low by widening our search for possible stations if the first route fails.

3.0.0

31 May 2021

GraphEngine 3.0

API updated

⚡️ New features

  • Chargetrip's Graph Engine has been rebuild from the ground-up to maintain performance and withstand higher loads. The new version of the engine calculates routes faster, uses more variables and gives back better results.

✨ Improvements

  • Improved the client environment's stability by moving the import and processing of station data outside the client environment.
  • Improved route calculation speeds when searching for stations along a route.
  • Improved route calculation speeds when using preferred operators.
  • Improved car data processing.

2.58.6

11 May 2021

Introducing pagination to the car database

API updated

⚡️ New features

  • Added pagination to the carList query.
  • Added search over naming.make, naming.model, naming.chargetrip_version to the carList query.
  • Added filter for availability to the carList query.

2.38.3

27 Jan 2021

Car Database Structure

API updated

✨ Improvements

  • Improved car data structuring which allows for better clustering and query scalability.

🐞️ Bug fixes

  • Fixed a bug that prevented using stations as via point.

2.38.3

27 Jan 2021

Car Database Structure

API updated

✨ Improvements

  • Improved car data clustering. Fields are now categorized by using nesting.

2.33.1

17 Nov 2020

Predictive Availability Module

API updated

⚡️ New features

  • Station data has been extended and now includes historical station availability.

🐞️ Bug fixes

  • Fixed a bug where error codes were not consistent.

2.30.3

06 Nov 2020

Bug fixes & improvements

API updated

🐞️ Bug fixes

  • Fixed a bug that hid 24 / 7 information for some stations.
  • Fixed a bug where alternative routes with a single charge were not displayed correctly.

2.30.2

27 Oct 2020

Chargetrip Range

API updated

⚡️ New features

  • Added the chargetripRange field.

✨ Improvements

  • Migrated fields from the carList query to the car query to allow caching of the carList query.

🐞️ Bug fixes

  • Fixed a bug where the number of amenities were not equal when comparing between the stationList and amenityList.

2.27.5

15 Oct 2020

New Outside Temperature Model

API updated

✨ Improvements

  • Improved outside temperature model which enhances the route computation speed and improves the charge stop accuracy.
  • Various other improvements to improve our route calculation speed.

🐞️ Bug fixes

  • Fixed a bug where the ordering of alternative routes was wrong.

2.24.0

14 Sep 2020

Custom Error Codes

API updated

⚡️ New features

  • Added custom error codes and detailed error descriptions. No more guess-work.

🐞️ Bug fixes

  • Various small bug fixes.

2.22.2

27 Aug 2020

Bug Fixes & improvements

API updated

✨ Improvements

  • Improved the description of our recently released chargetripEdition field.
  • Improved various chargetripEdition field names to be more descriptive.

🐞️ Bug fixes

  • Fixed a bug where via points were not correctly added to the route.

2.22.0

26 Aug 2020

Chargetrip Edition

API updated

⚡️ New features

  • Added the chargetripEdition field.

2.21.8

07 Aug 2020

Bug Fixes

API updated

🐞️ Bug fixes

  • Fixed a spelling mistake by renaming recommandedSpeed to recommendedSpeed.
  • Fixed the destination type from stationVia to stationFinal when adding a station as final destination.

2.21.0

20 Jul 2020

Alternative Stations

API updated

⚡️ New features

  • Added the ability to request alternative stations along an existing route.
  • Added the ability to set charge stations as waypoints to an existing route.

🐞️ Bug fixes

  • Renamed the stationAlong field to stationsAlongRoute.

2.19.0

16 Jul 2020

Tile Service Filter

API updated

⚡️ New features

  • Added support for selecting different power filters.
  • Added support to select all available connectors.

🐞️ Bug fixes

  • Fixed various spelling mistakes and inconsistencies in our documentation.

2.15.0

10 Jun 2020

OCPI 2.2 Support

API updated

⚡️ New features

  • Added support for OCPI 2.2. OCPI specifications can be found here. The full specifications can be found here.

2.0.0

01 Apr 2020

OCPI 2.1.1 Support

API updated

⚡️ New features

  • Added an exclusive Eco-Movement integration.
  • Added support for OCPI 2.1.1

🐞️ Bug fixes

  • Fixed various spelling mistakes and inconsistencies in our documentation.
  • Fixed missing descriptions for all types that return values with a unit.

1.0.0

18 Jan 2020

Generation 3 of the Chargetrip API

API updated

⚡️ New features

  • Added support for Peugeot e-208 and Seat Mii Electric.
  • Added support for the OCPI Tarrif Module. More information about the OCPI 2.1.1 specifications can be found here. The full specifications can be found here.

🐞️ Bug fixes

  • Fixed various spelling mistakes and inconsistencies in our documentation.