From 34743f8df34dab320ded88a85faa58debda46ae6 Mon Sep 17 00:00:00 2001 From: simu Date: Fri, 10 Jun 2022 08:37:28 +0000 Subject: [PATCH] Update from projectsyn/modulesync-control --- .gitignore | 18 +++++++++--------- README.md | 8 +++++++- docs/antora.yml | 4 +++- 3 files changed, 19 insertions(+), 11 deletions(-) diff --git a/.gitignore b/.gitignore index 8824f80f..d57e02e7 100644 --- a/.gitignore +++ b/.gitignore @@ -5,17 +5,17 @@ # # Commodore -.cache/ -helmcharts/ -manifests/ -vendor/ -jsonnetfile.lock.json -crds/ -compiled/ +/.cache +/helmcharts +/manifests +/vendor +/jsonnetfile.lock.json +/crds +/compiled # Antora -_archive/ -_public/ +/_archive +/_public # Additional entries jsonnetfile.json diff --git a/README.md b/README.md index 005fc309..7b3601ba 100644 --- a/README.md +++ b/README.md @@ -7,15 +7,21 @@ For documentation on Project Syn and this component, see https://syn.tools. ## Documentation +The rendered documentation for this component is available on the [Commodore Components Hub](https://hub.syn.tools/keycloak). + Documentation for this component is written using [Asciidoc][asciidoc] and [Antora][antora]. It is located in the [docs/](docs) folder. The [Divio documentation structure](https://documentation.divio.com/) is used to organize its content. +Run the `make docs-serve` command in the root of the project, and then browse to http://localhost:2020 to see a preview of the current state of the documentation. + +After writing the documentation, please use the `make docs-vale` command and correct any warnings raised by the tool. + ## Contributing and license This library is licensed under [BSD-3-Clause](LICENSE). For information about how to contribute see [CONTRIBUTING](CONTRIBUTING.md). -[commodore]: https://docs.syn.tools/commodore/index.html +[commodore]: https://syn.tools/commodore/ [asciidoc]: https://asciidoctor.org/ [antora]: https://antora.org/ diff --git a/docs/antora.yml b/docs/antora.yml index e043a1b2..89d68083 100644 --- a/docs/antora.yml +++ b/docs/antora.yml @@ -1,7 +1,9 @@ # # File managed by ModuleSync - Do Not Edit # -# The name and title can be customized in `.sync.yml` with `'docs/antora.yml'.title`, `'docs/antora.yml'.name` +# The title can be customized in `.sync.yml` with `:global.componentName` +# The name is generated from the component's GitHub repository name, with the +# `component-` prefix removed. # name: keycloak