Better Marketing

[boulter]

It would be nice to have a proper site with more extensive documentation, samples and community.

See http://jtwig.org/ as an example.

[prior]

and for those docs -- would be nice to note the differences between jinja and jinjava --- like .items() vs .iteritems()

[boulter]

We should just fix that :)

[prior]

We should just fix that :)

Agreed -- I went ahead and created an issue for that: https://github.com/HubSpot/jinjava/issues/167.

However, I believe my larger point is still valid. There are apparently purposeful differences between jinja2 and jinjava where documentation would definitely be helpful. For instance the presence of md5 and unixtimestamp filters that are not part of the standard jinja2 builtins

[boulter]

Maybe use https://docusaurus.io/ ?

[prior]

ooooo -- i really like that -- gonna have to remember docusaurus

[TheWebTech]

Us third-party HS developers would appreciate an official HS documentation site like this and I think at-least a handful of us that frequent the slack channel would help contribute.

Current and more extensive documentation is a win-win for both you guys and us third party developers.

(I'm Jon McLaren, from the HubSpot Design & Developers Slack)

[boulter]

Thanks, Jon. Any documentation here would be a subset of what's on designers.hubspot.com since there are HubSpot-specific extensions on top of Jinjava.

[TheWebTech]

I guess to clarify. I would actually support an open source project or some form of wiki for the HubSpot designer/developer documentation. It could link to the jinjava specific documentation wherever necessary to prevent accidental overlap.

[mattcoley]

Why not power open-source documentation with gitbooks and keep documentation in this repo similar to Singularity?

[boulter]

For any solution, I think the doc source should be in this repo.