extra comments for clarity of public js