Платформа является фундаментом
Один взгляд на программную платформу является основой, на которую опирается другое программное обеспечение для выполнения другой задачи. Это может показаться простым и довольно очевидным утверждением, но оно важно.
Основы должны быть простыми
Платформа должна иметь цель, и разработчики платформы должны знать об этом при разработке API, чтобы стало очевидно, каковы основные варианты использования, а API вокруг них должны быть сделаны как можно более простыми в использовании в отношении способа они разработаны, но также с учетом документации вокруг них.
Точки расширения должны быть очевидны
Расширяемость в платформе заключается в предоставлении разработчикам возможности расширить или изменить платформу. Если это то, что вы хотите поощрять, тогда вам нужно очень четко разъяснить природу и ограничения этой расширяемости и предоставить четко определенный набор интерфейсов, позволяющих это сделать.
Все это может показаться очевидным, но если вы хотите, чтобы сообщество развивалось вокруг платформы, эта платформа должна иметь применение, и ее расширение должно быть простым опытом.
Извините, если это звучит немного "архитектурно-астронавтически", я думаю, что я сделал некоторые правильные замечания, я, возможно, сделал их плохо, не стесняйтесь указать на это или добавить к ним