It should, for developers. Use the Scaladocs to document the intent just stated (that the companion object exists to hold a private inner class used for test instances of KijiSource).