Add ability to document macros

[dwallace0723]

Ability to

Feature description

Currently, dbt's native documentation functionality is built around the concept of documenting models. it would be equally as useful to have the ability to document macros.

Who will this benefit?

Anyone who leverages macros, especially within a large data org.

[ArvindEnvoy]

👍

[drewbanin]

Thanks @dwallace0723. I figure we can:

1. Enumerate the macros defined in a project
2. Expose the macro code
3. Expose models that call that macro

Do you imagine also writing markdown docs for macros? Or do you think that inline comments are sufficient? We don't currently have a mechanism for documenting macros, and I don't think it would make sense to extend the schema.yml syntax.

Maybe there's a tie-in here: #979?

[dwallace0723]

@drewbanin I do think there is a tie-in to #979. I think documenting the macro inline via a docs block would be a perfectly fine solution here.

[Fokko]

Looking for this as well :-)

[beckjake]

Fixed in #2068

[Fokko]

Sweet! 👏