Merge pull request #270 from projectsyn/prepare-0.4.1

Prepare release v0.4.1

Author: simu

CHANGELOG.md

@@ -7,11 +7,14 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [v0.4.1] 2020-12-28
+
 ### Added
 * Add GitHub action to build Kapitan docker image from `tools/Dockerfile.kapitan` ([#266])
 
 ### Changed
 * Always create targets from component aliases ([#269])
+* Update dependencies ([#200])
 
 ### Fixed
 * Correctly create a local branch when overriding component version ([#262])
@@ -275,6 +278,7 @@ Initial implementation
 [#190]: https://github.com/projectsyn/commodore/pull/190
 [#192]: https://github.com/projectsyn/commodore/pull/192
 [#195]: https://github.com/projectsyn/commodore/pull/195
+[#200]: https://github.com/projectsyn/commodore/pull/200
 [#201]: https://github.com/projectsyn/commodore/pull/201
 [#204]: https://github.com/projectsyn/commodore/pull/204
 [#211]: https://github.com/projectsyn/commodore/pull/211

docs/modules/ROOT/pages/reference/architecture.adoc

@@ -25,10 +25,19 @@ Commodore fetches the following dependencies:
 === Component discovery
 
 To discover all required components, Commodore reads the https://reclass.pantsfullofunix.net/operations.html#yaml-fs-storage[`applications` array] which is made available by reclass.
-Unless instructed otherwise, Commodore will fetch components from subfolder `commodore-components` in the xref:reference/cli.adoc#_catalog_compile[global Git base].
+If a component should be disabled in a subset of the hierarchy, it can be removed from the `applications` array by adding the component name prefixed with a `~`.
 
-The file `commodore.yml` in the root of the Global configuration repository can be used to override the repository autodiscovery for components.
-The file must contain a key `components` which holds an array of dictionaries with keys `name` and `url`.
+[source,yaml]
+----
+applications:
+  - ~component-to-remove
+----
+
+Note that this only works to remove components which have been included previously, and won't remove components that are included further down in the hierarchy.
+
+Commodore currently has no mechanism to automatically discover components based on their names.
+Instead all components which are referenced in the hierarchy must be listed in key `components` in the file `commodore.yml` in the root of the global configuration repository.
+The key `components` holds an array of dictionaries with keys `name` and `url`.
 Each array entry specifies the repository URL of a single component.
 A sample `commodore.yml` can be found below.
 The file `commodore.yml` is also used to define the xref:commodore:ROOT:reference:hierarchy.adoc[Commodore class hierarchy].