Database schemas change rapidly as project progresses. And it can be difficult to track purpose of each table and each column in a large project with multiple team members. The solution for this problem is to document data models right from Rails migrations. Solution in Rails 4 You can add comments in Rails 4.x migrations using gems like migration_comments and pg_comment. Solution in Rails 5 Rails