portals-project / portals

Portals is a framework for stateful serverless apps, unifying dataflow streaming with actors
https://www.portals-project.org/
Apache License 2.0
19 stars 2 forks source link

Public API classes and methods should have doc comments #204

Open jspenger opened 1 year ago

jspenger commented 1 year ago

All public facing API classes and methods should have doc comments. This is currently not the case, hence we have this issue.

In order to solve this task, we can split it into the following steps:

The results should be merged via a PR.

I suggest that @aversey first creates a list of all public classes that currently have no docs. There will also be non-private classes that should be private instead, please also mark these classes as private[portals].

Either @aversey, or @jonasspenger, or both can write the docs. I suggest also using co-pilot for this, as it helps with uniformity.