Hello all,

Here is a discussion thread for documentation.

This might be related to website, but let's mainly focus on documentation.

So far, each project has its own repo or module to generate its
documentation and publish it.

incubator-kie-drools/drools-docs : using antora
incubator-kie-optaplanner/optaplanner-docs : using antora
incubator-kie-kogito-docs (sonataflow) : using antora
incubator-kie-docs:master-kogito (kogito) : using asciidoctor

Topics to discuss are:

A) Hosting documentation

  - For example, Host those documentations under https://kie.apache.org/

B) Automation

  - For example, Create GHAs to generate docs, commit them to
incubator-kie-website, and rebuild incubator-kie-website to make them
available

C) Consolidate docs projects

  - Do we want to move docs projects to the same place?
  - Do we want to use the same technology for docs?
      FYI, antora is MPL-2.0 , asciidoctor is MIT License

The above are just some thoughts that came to mind.

Feel free to share your thoughts and start the discussion.

Btw, Here are some links about website for apache projects. However, I
can't find much about documentation.

https://incubator.apache.org/guides/sites.html
https://infra.apache.org/project-site.html
https://infra.apache.org/website-guidelines.html

Thanks!
Toshiya

Reply via email to