These are guidelines for code style and quality that we follow at UseTheSource.
General
- we use Google’s open source style guides as the following items are extensions or deviations from this guide.
- maximum line length: 100
- no tabs for indentation: 4 spaces.
- comments explain any otherwise implicit intent or purpose; otherwise code must speak for itself.
Java
- all public classes are documented with Javadoc to state their intent and purpose.
- all public methods are documented with Javadoc to state their intent and purpose.
- package names are
io.usethesource.<project>.<sub>
Rascal
- all public functions have @synopsis tags in Rascal tutor format.
- most public functions have @description and @examples tags in Rascal tutor format.
- tools for languages reside in
lang/<language name>/<sub?>/<tool name>.rsc
- generic algorithms for analysis reside in
analysis/<algorithm group>/<algorithm>.rsc
- generic utilities (i.e. for communication) reside in
utils/<utility>.rsc