Best practices/standards

[ebwinters]

I think it would be a good idea to start compiling a list of best practices we support. For example, ATProto and Bluesky write have defs.json whereas we seem to be putting the different defs in the schema file they are referenced in. I don't think there is a right or a wrong, but these types of standards for community-lexicon should live in a doc that can be referenced, which would also help focus PR discussions

Let's use this discussion to hash out standards, starting with the defs.json/in file object definitions. I would say our guidance there is to keep them in file, unless there is a special case