microsoft / code-with-engineering-playbook

This is the playbook for "code-with" customer or partner engagements
https://microsoft.github.io/code-with-engineering-playbook/
Creative Commons Attribution 4.0 International
2.15k stars 568 forks source link

Adding TypeSpec references #957

Closed mahomedalid closed 1 year ago

mahomedalid commented 1 year ago

Pull Request Template

What are you trying to address

In our last project we struggled to implement API design first until we leveraged into Microsoft TypeSpec, which is widely used in Azure PGs. I think adding references and information about TypeSpec would greatly improve the content about REST API references.

I am also adding cross references between design and documentation which seems is missing here.

mahomedalid commented 1 year ago

cc @wereinse @madossan01 @cyrusjones