ROSE Compiler Framework/How to incrementally work on a project

Developing a big, sophisticated project entails many challenges. To mitigate some of these challenges, we have adopted several best practices: incremental development, code review, and continuous integration. Here are some tips on how to divide up a big project into smaller, bite-sized pieces so each piece can be incrementally developed, code reviewed, and integrated. Input: define different sets of test inputs based on complexity and difficulty. Tackle simpler sets first. Output: define intermediate results leading to the final output. Often, results A and B are needed to generate C. So the project can have multiple stages, based on the intermediate results. Algorithm: complex compiler algorithms are often just enhanced versions of more fundamental algorithms. Implement the fundamental algorithms first to gain insight and experience. Then, afterward, you can implement the full-blown versions. Language: for projects dealing with multiple languages, focus on one language at a time. Platform: limit the scope of supported platforms: Linux, Ubuntu, OS X (TODO: add reference to ROSE supported platforms) Performance: Start with a basic, working implementation first. Then try to optimize its performance, efficiency. Scope: your translator could first focus on working at a function scope, then grow to handle an entire source file, or even multiple files, at the same time. Skeleton then meat: a project should be created with the major components defined first. Each component can be enriched separately later on. Annotations (manual vs. automated): Performing one compiler task often requires results from many other tasks being developed. Defining source code annotations as the interface between two tasks can decouple these dependencies in a clean manner. The annotations can be first manually inserted. Later the annotations can be automatically generated by the finished analysis. Optional vs. Default: introducing a flag to turn on/off your feature. Make it as a default option when it matures.