Read table description from external files

[mokshasoul]

Hi I posted in a wrong thread, but it would be great if there would be some support of sourcing external files for table descriptions (preferably makrdown).

This would enable us to have renderable + re-usable table descriptions across the repository the same way that dbt does it as well as make the sqlx file themselves smaller

[Ekrekr]

I suspect this wouldn't be too hard to implement:

• Add a .md file reader to the compiler

  dataform/core/compilers.ts

  Line 21 in 2531b12

  export function compile(code: string, path: string): string {

• Expose a new JS method, like getContents("file.md") in the session https://github.com/dataform-co/dataform/blob/main/core/session.ts
• Attach it to the global session, similar to how we do current attaching

  dataform/core/main.ts

  Line 77 in 2531b12

  globalAny.publish = session.publish.bind(session);