3 ms·
Really glad to see this coming. Sharing my experience of using Git for rendering docs and blog at Iterative. We've build a similar engine for the https://dvc.or
by shcheklein 4y ago
Really glad to see this coming. Sharing my experience of using Git for rendering docs and blog at Iterative. We've build a similar engine for the https://dvc.org/doc https://dvc.org/doc and https://iterative.ai/blog https://iterative.ai/blog (internally it's Git + DVC for images + Gatsby + Markdown deployed on Heroku (only for APIs) + Cloudflare + S3).
It's been working really great. GitHub PRs + preview applications give a very powerful collaboration / review framework. It works extremely well for folks who understand Git / GitHub enough - engineers, technical writers, etc.
It's starts breaking unfortunately for the marketing team, less tech savvy folks. I was trying to find a solution CMS that would work for them, but haven't seen so far something that would satisfy our needs. Two things that we are usually missing:
- we need a way for people to come and review it (ideally GitHub / Notion / GoogleDoc style). Where you would be able to comment on a line, suggest and edit, etc, etc
- we need a way to handle assets better (using Git for blog was not scalable - started breaking the workflow). So far we ended up using DVC for this, but it complicates the workflow.
- there are merge conflicts that are happening - that's not easy to resolve in CMS
Nonetheless, even a tool that would prepare and generate a PR using an online editor is already a very decent step to my mind. Eager to try the tool.