Skip to content
This repository was archived by the owner on Sep 17, 2025. It is now read-only.
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
PRs are always welcome, and we'll be happy to merge them if the test suite passes.

To run the entire test suite would take a long time, so we've broken it down into various groups:

``` shell
TEST_TARGET=lint make test
TEST_TARGET=unit make test
TEST_TARGET=e2e make test
TEST_TARGET=cov make test
```

All of these will be run by Travis, but you could save the ice caps from melting a little by running at least `unit` and `e2e` before you push.

Our sole requirement is that organizations that want to extend API-Flow to support their format write both a parser and a serializer, and not simply a serializer.
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,11 +91,13 @@ API-Flow is one of the main components of [Console.REST](https://github.com/luck

## Contributing

PRs are welcomed!
Read [CONTRIBUTING.md](CONTRIBUTING.md) for more tips on testing and contributing.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍


Our sole requirement is that organizations that want to extend API-Flow to support their format write both a parser and a serializer, and not simply a serializer.

## Documentation
You can find more information about the internal structure of API-Flow in [src](https://github.com/luckymarmot/API-Flow/tree/develop/src). We've also created a set of templates to help speed up the extension process: [loader](https://github.com/luckymarmot/API-Flow/tree/develop/src/loaders/template/v1.0), [parser](https://github.com/luckymarmot/API-Flow/tree/develop/src/parsers/template/v1.0/), and [environment](https://github.com/luckymarmot/API-Flow/tree/develop/src/environments/template)

You can find more information about the internal structure of API-Flow in [src](src). We've also created a set of templates to help speed up the extension process: [loader](src/loaders/template/v1.0), [parser](src/parsers/template/v1.0/), and [environment](src/environments/template)

## License

Expand Down