Unfortunately the documentation is not yet ready. ...

# scripting

[ilya.chernikov]

Unfortunately the documentation is not yet ready. In fact some parts of the scripting support are not finalized yet.
Yes, the regular scripts should be part of the regular project structure (reside under a source root) in order to receive proper treatment from the IDEA.