commit | 86d1e9160523c9ce7bed0894f0cef0763e7a58f8 | [log] [tgz] |
---|---|---|
author | csherrar <csherrar@redhat.com> | Thu Jul 14 18:14:39 2022 +0100 |
committer | GitHub <noreply@github.com> | Thu Jul 14 13:14:39 2022 -0400 |
tree | c763d2cab28d7e78ccc1d0696b41b9814bca61ee | |
parent | f66bca1424c758958e977cb720a5c25aaa6b0de3 [diff] |
BXMSDOC-8462-main: Add optional step for using Secrets (#4280) * BXMSDOC-8462-main: Add optional step for using Secrets * BXMSDOC-8462-main: Adopt feedback
If either of the two badges above are not green, please get in contact with engineering: some document might no longer be aligned.
On August 31, 2018, this kie-docs
repository that contains KIE community and Red Hat Business Automation documentation was updated to enable shared content between KIE community and Red Hat Business Automation enterprise documentation, to remove obsolete content, and to prepare for an improved content building tool coming soon (Aura).
To get the latest changes made to this kie-docs
repository, delete your local kie-docs
master branch, pull the new kie-docs
master to your cloned repository, and force push to your fork:
$ cd ~/kie-docs/ $ git checkout <branch-other-than-master> $ git branch -d master $ git fetch --all $ git checkout --track <upstream-repo-name>/master $ git push --set-upstream <fork-name> master
WARNING: Do not rebase your existing master branch against kie-docs
master branch to get the latest updates. The new master is substantially restructured, so rebasing creates extensive conflicts that, even when resolved, can introduce errors into the new structure.
To access legacy content from the former master branch, use the branch backup-master-2018.08.31
.
Note the following changes that apply to KIE community documentation as a result of the repository update:
kie-docs
repository structure: The kie-docs
repository has been restructured to prepare for an improved content building tool coming soon (Aura) and to enable shared content between KIE community and Red Hat Business Automation enterprise documentation. Within the doc-content
directory, the community drools-docs
, jbpm-docs
, and optaplanner-wb-es-docs
folders continue to be in a Maven structure as before that supports a mvn clean install -Dfull
build. All content files in community folders are or can now be used in enterprise assembly builds from the assemblies
folder for the Red Hat Customer Portal. Content files in the enterprise-only
folder either apply only to Red Hat Business Automation products or are files that have not yet been reconciled with community content. Each content folder contains sub-directories divided roughly by subject matter._images
directory: Going forward, save all new images to only the central kie-docs/_images
directory instead of in separate sub-directories within the community content folders. Existing images have been moved already, or deleted if unused. Any images that you save outside of that central images folder will not be rendered in the output.:imagesdir:
declaration in modules: Going forward, do not specify an :imagesdir:
declaration in any module files or in any KIE community index.adoc
assembly files. The images directory specification is now configured globally in the KIE community project pom.xml
settings, and directs to the central kie-docs/_images
directory. Only Red Hat Business Automation main.adoc
assembly files require an :imagesdir:
specification.For more information about these documentation changes or about contributing to this kie-docs
documentation repository, see Contributing to KIE documentation.
For guidelines on contributing to a kiegroup
development project, see droolsjbpm-build-bootstrap/README.md.
For guidelines on contributing to this kie-docs
documentation repository, see Contributing to KIE documentation.