No documentation on how to write plugins.

In GitLab by @graingert on Jan 18, 2017, 04:39

I currently maintain https://pypi.python.org/pypi/flake8-commas and I'm trying to port it to flake8 >=3.

I currently only need the simple tokenize token stream to work.

However there's no documentation on what I should do to change my plugin to work with flake8 3.

http://flake8.pycqa.org/en/latest/plugin-development/index.html#getting-started
and http://flake8.pycqa.org/en/latest/plugin-development/registering-plugins.html

mention adding an entry point 'X = flake8_example:ExamplePlugin',

but not what ExamplePlugin should look like.

Do I use a run method? __init__ ? etc.

Start with the plugin-development getting-started and registering-plugins pages linked in the issue, focusing on the ExamplePlugin entry point. Document the plugin interface, including whether plugins use run or init, and explain the simple tokenize token-stream migration for flake8 3; done means a plugin author can implement and register a working example.