add star/fork badges
document $ assignment behavior