Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/trolie/spec

Transmission Ratings and Operating Limits Information Exchange
https://github.com/trolie/spec

electricity-grid energy interoperability openapi-specification

Last synced: 9 days ago
JSON representation

Transmission Ratings and Operating Limits Information Exchange

Awesome Lists containing this project

README

        

[![Redocly OpenAPI lint](https://github.com/trolie/spec/actions/workflows/lint.yaml/badge.svg)](https://github.com/trolie/spec/actions/workflows/lint.yaml)
[![OWASP Top 10 Spectral lint](https://github.com/trolie/spec/actions/workflows/owasp.yaml/badge.svg)](https://github.com/trolie/spec/actions/workflows/owasp.yaml)

# TROLIE 1.0 Specification Working Group

Official LF Energy Standards and Specifications logo

The Transmission Ratings and Operating Limits Information Exchange (TROLIE) 1.0
specification is an LF Energy Standards and Specification Working Group. The
official website is [trolie.energy](https://trolie.energy).

## Scope

The aim of the Working Group is to facilitate interoperability for organizations implementing FERC Order 881. In particular we are developing an [OpenAPI Specification](https://trolie.energy/spec). Please see [Scope](./Scope.md) for a thorough description of the Working Group's charge.

## License

The OpenAPI specification is licensed under the [Community Specification License 1.0](Community_Specification_License.md).

Source code is otherwise licensed under [Apache 2.0](https://opensource.org/license/apache-2-0).

For more details see [LICENSE.md](LICENSE.md).

## Contributing

There are three roles for contributors: Maintainers, Editors, and Participants. See the [Governance Policy](Governance.md).

All contributions to the TROLIE Specification 1.0 Working Group are done under the [Community Specification Contributor License Agreement](Contributor_License_Agreement.md).

### Compiling the Site and Specification Locally

The `docs/` folder contains a Jekyll site for the GH Pages along with the yaml
that is used with `redocly bundle` to create the OpenAPI specification.

To simplify the local setup of the toolchain, a devcontainer is provided. This
will also install VS Code extensions to help with local editing.

#### Self-Signed Certs and Repo Proxies

If your company uses MITM, self-signed certificates through your Internet proxy
and/or proxies upstream RubyGem or npm repos, please follow these instructions
to get the local devcontainer editing experience working.

Put your company's self-signed cert in a PEM file at: `.devcontainer/root.pem`

You can use your company's RubyGem and npm proxies by specifying them in
`.devcontainer\devcontainer.json` by replacing:

```json
"containerEnv": {
"GEM_REPO": "https://rubygems.org",
"NPM_CONFIG_REGISTRY": "https://registry.npmjs.org"
}
```