improved the documentation for JHipster with spotless in README.md

This commit is contained in:
Michael Hoennig 2019-04-30 18:35:24 +02:00
parent be52181b7e
commit f40a574ec3

View File

@ -37,39 +37,56 @@ The jhipster-generated git branch tracks the history of the JDL model file
and the generated source code. The project has to be resetted to a clean state and the generated source code. The project has to be resetted to a clean state
(without any generated entities) before changes to the JDL file can be imported. (without any generated entities) before changes to the JDL file can be imported.
| WARNING: This workflow is currently changing, do NOT use! | | WARNING: This is just a guideline. You should understand what you are doing! |
| --------------------------------------------------------- | | ---------------------------------------------------------------------------- |
# Prepare/Cleanup Workspace
git checkout jhipster-generated git checkout jhipster-generated
git pull
git tag REAL-HEAD
git reset --hard jdl-base git reset --hard jdl-base
git clean -f -d git clean -f -d
git checkout HEAD@{1} src/main/jdl/customer.jdl git cherry-pick -n spotless
git reset HEAD . git reset --soft REAL-HEAD
git checkout REAL-HEAD src/main/jdl/customer.jdl # AND OTHERS!
git tag -d REAL-HEAD
# Apply changes to the jdl file # MANUAL STEP: Apply changes to the jdl file!
# Invoke JHipster generator # (Re-) Importing
jhipster import-jdl src/main/jdl/customer.jdl
jhipster import-jdl src/main/jdl/accessrights.jdl
# AND OTHERS, if applicable!
jhipster import-jdl src/main/jdl/customer.jdl --force gw spotlessApply
# Let Git determine change set between most recent commit and the re-generated source
git reset --soft HEAD@{1}
git reset HEAD .
git add . git add .
git commit -m"..."
# Commit changeset # MANUAL STEP:
# - if you've renamed any identifiers, use refactoring to rename in master as well BEFORE MERGING!
git commit -m '...'
# Merge changeset into master branch # Merge changeset into master branch
git checkout master git checkout master
git merge jhipster-generated git merge jhipster-generated
### Amending the spotless commit
If you need to amend the commit tagged 'spotless', e.g. to change the spotless configuration,
it can be done with these steps:
git tag REAL-HEAD
git reset --hard spotless^
git cherry-pick -n spotless
...
git add .
# do NOT run: gw spotlessApply yet!
# for the case you have a commit hook which runs spotlessCheck:
git commit --no-verify
git tag --force spotless
git push --no-verify origin spotless
git reset --hard REAL-HEAD
git tag -d REAL-HEAD
## HOWTO do This and That ## HOWTO do This and That
There are git tags on some commits which show how to add certian features. There are git tags on some commits which show how to add certian features.