search

OData / odataorg.github.io

Staging site and collaboration repository for http://www.odata.org
MIT License
63 stars 101 forks source link

New intro text on OData Why and What? #173

Open nicenemo opened 5 years ago

nicenemo commented 5 years ago

Hi,

I was asked to give an introductionary course on OData. I was please to see the new updated OData tutorals, e.g. Odata in 6 steps. Compliments for who wrote those. This explains the how beautiful.

What is still missing on the OData site is a nice introductionary text. I something like that planned already? There are some great bits and peaces that can be googled but that go in to much detail or are outdated.

IMHO it should describe:

  1. The Why
  2. The Where (Name a few open and commercial services that use it).
  3. The What (without going into to much specification details but highlight the good parts: a. 'JDBC for the web; b.being typed via the schema c. CRUD d. navigating down e. SELECT, FILTER f. paging top/skip
  4. Depending on the audience it can refer to LINQ, Java Streams and or the list monad (without flatmap).
  5. Compare to Swagger and Facebook graph

I think the following is to much detail already:

  1. Where the EDM comes from and why does the OData type system looks so much like the CLRs.