docs: provide guidance on how patterns, practices, things to avoid

[EisenbergEffect]

We should take more of our learnings from building components and experience and produce documentation that leads customers into the pit of success.

• Project organization
• File structure
• Naming components/classes
• How to think about state
• TypeScript practices
• Styling

[adamcee]

Agreed : ). Looking at FAST and finding it fascinating. Half of my curiosity is that it is, in the code, well-documented UI component behavior/state, independent of implementation.

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[send2vinnie]

Pure Javascript practices such as how to work without decorators in the various topics are also suggested. DI without decorators

[janechu]

This is being addressed in the documentation update to @microsoft/fast-element v2, including a component library section for developers looking to publish their own component packages.