Good workflow for making changes to a single component?
I'm trying to decide whether antora is right for us and the documentation is not helping very much. What I'd like is a way to see changes to a component without pushing to the server (and ideally without committing). Maybe some sort of way to generate the site, but override the git repository with a local directory for a particular component. Does such a thing exist?
To me, it sounds like the current workflow is:
- Make changes to component
- Commit
- Push
- Open MR in component repo
- Get someone to accept MR (without them really being able to preview it)
- Merge MR into master
- Wait for CI pipeline to generate the final site
- if (siteDoesNotLookGood) GOTO 1
Step 5 is particularly concerning to me, and something I want to avoid in our workflows. Also, it's just a lot of steps to see the final site rendered. An ideal workflow for me would be:
- Make changes to component
- Run a command that generates the site almost as normal, except uses my local directory for that particular component
- View changes in browser
- if (siteDoesNotLookGood) GOTO 1
- Open MR to component
- CI builds site, using the commit from the MR as an additional branch for the component
- Get someone to accept MR (allowing them to see the site as a build artifact if they like)
- Merge MR into master
- Wait for CI pipeline to generate the final site