You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@kie.apache.org by Dominik Hanak <do...@gmail.com> on 2025/02/06 11:47:39 UTC
[PROPOSAL] Fix missing documentation for 10.0.0
Hello Community,
here is a proposal on how to resolve the missing documentation for 10.0.0.
I think I have a working MVP in a form of pull-request on website so I
think it
is a good time to get more feedback.
You can also vote if you consider this good enough.
I also call to arms the SME's of Drools, Kogito & JBPM, I need your help!
Github Issue - https://github.com/apache/incubator-kie-issues/issues/1803
Pull-request for website -
https://github.com/apache/incubator-kie-website/pull/18
*Summary*
Fix missing documentation guides for 10.0.0 release by updating, building
the individual docs in (incubator-kie-drools, incubator-kie-kogito-docs,
incubator-kie-docs) and including them as static content into the current
website.
*Details*
A new sidebar called Documentation is created with references to Main and
Release streams.
Main page will summarize development and common information.
Release stream pages will showcase each component as Chapter.
The individual docs will be included as IFRAME referencing the content in
static
A workflow action will be modified to:
1. Checkout drools, sonataflow, jbpm, kogito docs repositories
2. Build each
3. Checkout website
4. Copy built docs into the website static folder
5. Build site
6. Deploy site
*Status*
I am sharing the updates in the github issue,short summary here:
* Sonataflow is ready, we might still need to review the compliance to
apache guidelines.
* Kogito and JBPM are stalled in this PR -
https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an SME
here so I urge everyone again to help.
* Drools had docs moved away from 10.0.x, if someone from SME's can
reinstate them and take care of this let me know. I will just include the
steps in the workflow to deploy the website.
*Goals*
Update docs for each component to 10.0.0.
Include them in the website deploy process for 10.0.0
Deploy new content for 10.0.0
Let me know what you think, I also suggest to provide feedback directly on
PR's
Best regards,
Dominik
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Toshiya Kobayashi <to...@gmail.com>.
Hi,
Filed a PR to prepare drools-docs for 10.0.0.
https://github.com/apache/incubator-kie-drools/pull/6245/
Thanks!
Toshiya
On Fri, Feb 7, 2025 at 2:16 PM Toshiya Kobayashi <to...@gmail.com>
wrote:
> Thank you, Dominik!
>
> > * Drools had docs moved away from 10.0.x, if someone from SME's can
> > reinstate them and take care of this let me know. I will just include the
> > steps in the workflow to deploy the website.
>
> Sure, I'm looking and will update soon.
>
> Regards,
> Toshiya
>
>
> On Thu, Feb 6, 2025 at 9:18 PM Gabriele Cardosi <
> gabriele.cardosi@gmail.com> wrote:
>
>> Thanks Dominik!
>>
>> Il giorno gio 6 feb 2025 alle ore 13:15 Alex Porcelli <al...@porcelli.me>
>> ha
>> scritto:
>>
>> > +1 big time!
>> >
>> > Thank you for the initiative, Dominik!
>> >
>> > Regards,
>> > _____________
>> > Alex Porcelli
>> > http://porcelli.me
>> >
>> >
>> > On Thu, Feb 6, 2025 at 6:48 AM Dominik Hanak <do...@gmail.com>
>> > wrote:
>> >
>> > > Hello Community,
>> > >
>> > > here is a proposal on how to resolve the missing documentation for
>> > 10.0.0.
>> > > I think I have a working MVP in a form of pull-request on website so I
>> > > think it
>> > > is a good time to get more feedback.
>> > > You can also vote if you consider this good enough.
>> > >
>> > > I also call to arms the SME's of Drools, Kogito & JBPM, I need your
>> help!
>> > >
>> > > Github Issue -
>> > https://github.com/apache/incubator-kie-issues/issues/1803
>> > > Pull-request
>> > > <
>> https://github.com/apache/incubator-kie-issues/issues/1803Pull-request>
>> > > for website -
>> > > https://github.com/apache/incubator-kie-website/pull/18
>> > >
>> > > *Summary*
>> > >
>> > > Fix missing documentation guides for 10.0.0 release by updating,
>> building
>> > > the individual docs in (incubator-kie-drools,
>> incubator-kie-kogito-docs,
>> > > incubator-kie-docs) and including them as static content into the
>> current
>> > > website.
>> > >
>> > > *Details*
>> > > A new sidebar called Documentation is created with references to Main
>> and
>> > > Release streams.
>> > > Main page will summarize development and common information.
>> > > Release stream pages will showcase each component as Chapter.
>> > > The individual docs will be included as IFRAME referencing the
>> content in
>> > > static
>> > > A workflow action will be modified to:
>> > > 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
>> > > 2. Build each
>> > > 3. Checkout website
>> > > 4. Copy built docs into the website static folder
>> > > 5. Build site
>> > > 6. Deploy site
>> > >
>> > > *Status*
>> > > I am sharing the updates in the github issue,short summary here:
>> > > * Sonataflow is ready, we might still need to review the compliance to
>> > > apache guidelines.
>> > > * Kogito and JBPM are stalled in this PR -
>> > > https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an
>> SME
>> > > here so I urge everyone again to help.
>> > > * Drools had docs moved away from 10.0.x, if someone from SME's can
>> > > reinstate them and take care of this let me know. I will just include
>> the
>> > > steps in the workflow to deploy the website.
>> > >
>> > > *Goals*
>> > > Update docs for each component to 10.0.0.
>> > > Include them in the website deploy process for 10.0.0
>> > > Deploy new content for 10.0.0
>> > >
>> > > Let me know what you think, I also suggest to provide feedback
>> directly
>> > on
>> > > PR's
>> > >
>> > >
>> > > Best regards,
>> > >
>> > > Dominik
>> > >
>> >
>>
>
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Toshiya Kobayashi <to...@gmail.com>.
Thank you, Dominik!
> * Drools had docs moved away from 10.0.x, if someone from SME's can
> reinstate them and take care of this let me know. I will just include the
> steps in the workflow to deploy the website.
Sure, I'm looking and will update soon.
Regards,
Toshiya
On Thu, Feb 6, 2025 at 9:18 PM Gabriele Cardosi <ga...@gmail.com>
wrote:
> Thanks Dominik!
>
> Il giorno gio 6 feb 2025 alle ore 13:15 Alex Porcelli <al...@porcelli.me>
> ha
> scritto:
>
> > +1 big time!
> >
> > Thank you for the initiative, Dominik!
> >
> > Regards,
> > _____________
> > Alex Porcelli
> > http://porcelli.me
> >
> >
> > On Thu, Feb 6, 2025 at 6:48 AM Dominik Hanak <do...@gmail.com>
> > wrote:
> >
> > > Hello Community,
> > >
> > > here is a proposal on how to resolve the missing documentation for
> > 10.0.0.
> > > I think I have a working MVP in a form of pull-request on website so I
> > > think it
> > > is a good time to get more feedback.
> > > You can also vote if you consider this good enough.
> > >
> > > I also call to arms the SME's of Drools, Kogito & JBPM, I need your
> help!
> > >
> > > Github Issue -
> > https://github.com/apache/incubator-kie-issues/issues/1803
> > > Pull-request
> > > <
> https://github.com/apache/incubator-kie-issues/issues/1803Pull-request>
> > > for website -
> > > https://github.com/apache/incubator-kie-website/pull/18
> > >
> > > *Summary*
> > >
> > > Fix missing documentation guides for 10.0.0 release by updating,
> building
> > > the individual docs in (incubator-kie-drools,
> incubator-kie-kogito-docs,
> > > incubator-kie-docs) and including them as static content into the
> current
> > > website.
> > >
> > > *Details*
> > > A new sidebar called Documentation is created with references to Main
> and
> > > Release streams.
> > > Main page will summarize development and common information.
> > > Release stream pages will showcase each component as Chapter.
> > > The individual docs will be included as IFRAME referencing the content
> in
> > > static
> > > A workflow action will be modified to:
> > > 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> > > 2. Build each
> > > 3. Checkout website
> > > 4. Copy built docs into the website static folder
> > > 5. Build site
> > > 6. Deploy site
> > >
> > > *Status*
> > > I am sharing the updates in the github issue,short summary here:
> > > * Sonataflow is ready, we might still need to review the compliance to
> > > apache guidelines.
> > > * Kogito and JBPM are stalled in this PR -
> > > https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an
> SME
> > > here so I urge everyone again to help.
> > > * Drools had docs moved away from 10.0.x, if someone from SME's can
> > > reinstate them and take care of this let me know. I will just include
> the
> > > steps in the workflow to deploy the website.
> > >
> > > *Goals*
> > > Update docs for each component to 10.0.0.
> > > Include them in the website deploy process for 10.0.0
> > > Deploy new content for 10.0.0
> > >
> > > Let me know what you think, I also suggest to provide feedback directly
> > on
> > > PR's
> > >
> > >
> > > Best regards,
> > >
> > > Dominik
> > >
> >
>
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Gabriele Cardosi <ga...@gmail.com>.
Thanks Dominik!
Il giorno gio 6 feb 2025 alle ore 13:15 Alex Porcelli <al...@porcelli.me> ha
scritto:
> +1 big time!
>
> Thank you for the initiative, Dominik!
>
> Regards,
> _____________
> Alex Porcelli
> http://porcelli.me
>
>
> On Thu, Feb 6, 2025 at 6:48 AM Dominik Hanak <do...@gmail.com>
> wrote:
>
> > Hello Community,
> >
> > here is a proposal on how to resolve the missing documentation for
> 10.0.0.
> > I think I have a working MVP in a form of pull-request on website so I
> > think it
> > is a good time to get more feedback.
> > You can also vote if you consider this good enough.
> >
> > I also call to arms the SME's of Drools, Kogito & JBPM, I need your help!
> >
> > Github Issue -
> https://github.com/apache/incubator-kie-issues/issues/1803
> > Pull-request
> > <https://github.com/apache/incubator-kie-issues/issues/1803Pull-request>
> > for website -
> > https://github.com/apache/incubator-kie-website/pull/18
> >
> > *Summary*
> >
> > Fix missing documentation guides for 10.0.0 release by updating, building
> > the individual docs in (incubator-kie-drools, incubator-kie-kogito-docs,
> > incubator-kie-docs) and including them as static content into the current
> > website.
> >
> > *Details*
> > A new sidebar called Documentation is created with references to Main and
> > Release streams.
> > Main page will summarize development and common information.
> > Release stream pages will showcase each component as Chapter.
> > The individual docs will be included as IFRAME referencing the content in
> > static
> > A workflow action will be modified to:
> > 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> > 2. Build each
> > 3. Checkout website
> > 4. Copy built docs into the website static folder
> > 5. Build site
> > 6. Deploy site
> >
> > *Status*
> > I am sharing the updates in the github issue,short summary here:
> > * Sonataflow is ready, we might still need to review the compliance to
> > apache guidelines.
> > * Kogito and JBPM are stalled in this PR -
> > https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an SME
> > here so I urge everyone again to help.
> > * Drools had docs moved away from 10.0.x, if someone from SME's can
> > reinstate them and take care of this let me know. I will just include the
> > steps in the workflow to deploy the website.
> >
> > *Goals*
> > Update docs for each component to 10.0.0.
> > Include them in the website deploy process for 10.0.0
> > Deploy new content for 10.0.0
> >
> > Let me know what you think, I also suggest to provide feedback directly
> on
> > PR's
> >
> >
> > Best regards,
> >
> > Dominik
> >
>
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Alex Porcelli <al...@porcelli.me>.
+1 big time!
Thank you for the initiative, Dominik!
Regards,
_____________
Alex Porcelli
http://porcelli.me
On Thu, Feb 6, 2025 at 6:48 AM Dominik Hanak <do...@gmail.com> wrote:
> Hello Community,
>
> here is a proposal on how to resolve the missing documentation for 10.0.0.
> I think I have a working MVP in a form of pull-request on website so I
> think it
> is a good time to get more feedback.
> You can also vote if you consider this good enough.
>
> I also call to arms the SME's of Drools, Kogito & JBPM, I need your help!
>
> Github Issue - https://github.com/apache/incubator-kie-issues/issues/1803
> Pull-request
> <https://github.com/apache/incubator-kie-issues/issues/1803Pull-request>
> for website -
> https://github.com/apache/incubator-kie-website/pull/18
>
> *Summary*
>
> Fix missing documentation guides for 10.0.0 release by updating, building
> the individual docs in (incubator-kie-drools, incubator-kie-kogito-docs,
> incubator-kie-docs) and including them as static content into the current
> website.
>
> *Details*
> A new sidebar called Documentation is created with references to Main and
> Release streams.
> Main page will summarize development and common information.
> Release stream pages will showcase each component as Chapter.
> The individual docs will be included as IFRAME referencing the content in
> static
> A workflow action will be modified to:
> 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> 2. Build each
> 3. Checkout website
> 4. Copy built docs into the website static folder
> 5. Build site
> 6. Deploy site
>
> *Status*
> I am sharing the updates in the github issue,short summary here:
> * Sonataflow is ready, we might still need to review the compliance to
> apache guidelines.
> * Kogito and JBPM are stalled in this PR -
> https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an SME
> here so I urge everyone again to help.
> * Drools had docs moved away from 10.0.x, if someone from SME's can
> reinstate them and take care of this let me know. I will just include the
> steps in the workflow to deploy the website.
>
> *Goals*
> Update docs for each component to 10.0.0.
> Include them in the website deploy process for 10.0.0
> Deploy new content for 10.0.0
>
> Let me know what you think, I also suggest to provide feedback directly on
> PR's
>
>
> Best regards,
>
> Dominik
>
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Jason Porter <jp...@ibm.com.INVALID>.
Go for it, well needed!
--
Jason Porter
Software Engineer
He/Him/His
IBM
From: Dominik Hanak <do...@gmail.com>
Date: Thursday, February 6, 2025 at 04:50
To: dev@kie.apache.org <de...@kie.apache.org>
Subject: [EXTERNAL] [PROPOSAL] Fix missing documentation for 10.0.0
Hello Community,
here is a proposal on how to resolve the missing documentation for 10.0.0.
I think I have a working MVP in a form of pull-request on website so I
think it
is a good time to get more feedback.
You can also vote if you consider this good enough.
I also call to arms the SME's of Drools, Kogito & JBPM, I need your help!
Github Issue - https://github.com/apache/incubator-kie-issues/issues/1803
Pull-request for website -
https://github.com/apache/incubator-kie-website/pull/18
*Summary*
Fix missing documentation guides for 10.0.0 release by updating, building
the individual docs in (incubator-kie-drools, incubator-kie-kogito-docs,
incubator-kie-docs) and including them as static content into the current
website.
*Details*
A new sidebar called Documentation is created with references to Main and
Release streams.
Main page will summarize development and common information.
Release stream pages will showcase each component as Chapter.
The individual docs will be included as IFRAME referencing the content in
static
A workflow action will be modified to:
1. Checkout drools, sonataflow, jbpm, kogito docs repositories
2. Build each
3. Checkout website
4. Copy built docs into the website static folder
5. Build site
6. Deploy site
*Status*
I am sharing the updates in the github issue,short summary here:
* Sonataflow is ready, we might still need to review the compliance to
apache guidelines.
* Kogito and JBPM are stalled in this PR -
https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an SME
here so I urge everyone again to help.
* Drools had docs moved away from 10.0.x, if someone from SME's can
reinstate them and take care of this let me know. I will just include the
steps in the workflow to deploy the website.
*Goals*
Update docs for each component to 10.0.0.
Include them in the website deploy process for 10.0.0
Deploy new content for 10.0.0
Let me know what you think, I also suggest to provide feedback directly on
PR's
Best regards,
Dominik
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Gabriele Cardosi <ga...@gmail.com>.
+1
Il giorno ven 7 feb 2025 alle ore 10:57 Fabrizio Antonangeli <
fantonangeli@apache.org> ha scritto:
> +1
> Thanks Dominik
>
> On Fri, 2025-02-07 at 10:50 +0100, Pere Fernandez (apache) wrote:
> > +1
> >
> > On Fri, 7 Feb 2025 at 10:39, Yeser Amer <ya...@apache.org> wrote:
> >
> > > +1
> > >
> > > On 2025/02/06 11:47:39 Dominik Hanak wrote:
> > > > Hello Community,
> > > >
> > > > here is a proposal on how to resolve the missing documentation
> > > > for
> > > 10.0.0.
> > > > I think I have a working MVP in a form of pull-request on website
> > > > so I
> > > > think it
> > > > is a good time to get more feedback.
> > > > You can also vote if you consider this good enough.
> > > >
> > > > I also call to arms the SME's of Drools, Kogito & JBPM, I need
> > > > your help!
> > > >
> > > > Github Issue -
> > > https://github.com/apache/incubator-kie-issues/issues/1803
> > > > Pull-request for website -
> > > > https://github.com/apache/incubator-kie-website/pull/18
> > > >
> > > > *Summary*
> > > >
> > > > Fix missing documentation guides for 10.0.0 release by updating,
> > > > building
> > > > the individual docs in (incubator-kie-drools, incubator-kie-
> > > > kogito-docs,
> > > > incubator-kie-docs) and including them as static content into the
> > > > current
> > > > website.
> > > >
> > > > *Details*
> > > > A new sidebar called Documentation is created with references to
> > > > Main and
> > > > Release streams.
> > > > Main page will summarize development and common information.
> > > > Release stream pages will showcase each component as Chapter.
> > > > The individual docs will be included as IFRAME referencing the
> > > > content in
> > > > static
> > > > A workflow action will be modified to:
> > > > 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> > > > 2. Build each
> > > > 3. Checkout website
> > > > 4. Copy built docs into the website static folder
> > > > 5. Build site
> > > > 6. Deploy site
> > > >
> > > > *Status*
> > > > I am sharing the updates in the github issue,short summary here:
> > > > * Sonataflow is ready, we might still need to review the
> > > > compliance to
> > > > apache guidelines.
> > > > * Kogito and JBPM are stalled in this PR -
> > > > https://github.com/apache/incubator-kie-docs/pull/4538 - I am not
> > > > an SME
> > > > here so I urge everyone again to help.
> > > > * Drools had docs moved away from 10.0.x, if someone from SME's
> > > > can
> > > > reinstate them and take care of this let me know. I will just
> > > > include the
> > > > steps in the workflow to deploy the website.
> > > >
> > > > *Goals*
> > > > Update docs for each component to 10.0.0.
> > > > Include them in the website deploy process for 10.0.0
> > > > Deploy new content for 10.0.0
> > > >
> > > > Let me know what you think, I also suggest to provide feedback
> > > > directly
> > > on
> > > > PR's
> > > >
> > > >
> > > > Best regards,
> > > >
> > > > Dominik
> > > >
> > >
> > > -------------------------------------------------------------------
> > > --
> > > To unsubscribe, e-mail: dev-unsubscribe@kie.apache.org
> > > For additional commands, e-mail: dev-help@kie.apache.org
> > >
> > >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@kie.apache.org
> For additional commands, e-mail: dev-help@kie.apache.org
>
>
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Fabrizio Antonangeli <fa...@apache.org>.
+1
Thanks Dominik
On Fri, 2025-02-07 at 10:50 +0100, Pere Fernandez (apache) wrote:
> +1
>
> On Fri, 7 Feb 2025 at 10:39, Yeser Amer <ya...@apache.org> wrote:
>
> > +1
> >
> > On 2025/02/06 11:47:39 Dominik Hanak wrote:
> > > Hello Community,
> > >
> > > here is a proposal on how to resolve the missing documentation
> > > for
> > 10.0.0.
> > > I think I have a working MVP in a form of pull-request on website
> > > so I
> > > think it
> > > is a good time to get more feedback.
> > > You can also vote if you consider this good enough.
> > >
> > > I also call to arms the SME's of Drools, Kogito & JBPM, I need
> > > your help!
> > >
> > > Github Issue -
> > https://github.com/apache/incubator-kie-issues/issues/1803
> > > Pull-request for website -
> > > https://github.com/apache/incubator-kie-website/pull/18
> > >
> > > *Summary*
> > >
> > > Fix missing documentation guides for 10.0.0 release by updating,
> > > building
> > > the individual docs in (incubator-kie-drools, incubator-kie-
> > > kogito-docs,
> > > incubator-kie-docs) and including them as static content into the
> > > current
> > > website.
> > >
> > > *Details*
> > > A new sidebar called Documentation is created with references to
> > > Main and
> > > Release streams.
> > > Main page will summarize development and common information.
> > > Release stream pages will showcase each component as Chapter.
> > > The individual docs will be included as IFRAME referencing the
> > > content in
> > > static
> > > A workflow action will be modified to:
> > > 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> > > 2. Build each
> > > 3. Checkout website
> > > 4. Copy built docs into the website static folder
> > > 5. Build site
> > > 6. Deploy site
> > >
> > > *Status*
> > > I am sharing the updates in the github issue,short summary here:
> > > * Sonataflow is ready, we might still need to review the
> > > compliance to
> > > apache guidelines.
> > > * Kogito and JBPM are stalled in this PR -
> > > https://github.com/apache/incubator-kie-docs/pull/4538 - I am not
> > > an SME
> > > here so I urge everyone again to help.
> > > * Drools had docs moved away from 10.0.x, if someone from SME's
> > > can
> > > reinstate them and take care of this let me know. I will just
> > > include the
> > > steps in the workflow to deploy the website.
> > >
> > > *Goals*
> > > Update docs for each component to 10.0.0.
> > > Include them in the website deploy process for 10.0.0
> > > Deploy new content for 10.0.0
> > >
> > > Let me know what you think, I also suggest to provide feedback
> > > directly
> > on
> > > PR's
> > >
> > >
> > > Best regards,
> > >
> > > Dominik
> > >
> >
> > -------------------------------------------------------------------
> > --
> > To unsubscribe, e-mail: dev-unsubscribe@kie.apache.org
> > For additional commands, e-mail: dev-help@kie.apache.org
> >
> >
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@kie.apache.org
For additional commands, e-mail: dev-help@kie.apache.org
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by "Pere Fernandez (apache)" <pe...@apache.org>.
+1
On Fri, 7 Feb 2025 at 10:39, Yeser Amer <ya...@apache.org> wrote:
> +1
>
> On 2025/02/06 11:47:39 Dominik Hanak wrote:
> > Hello Community,
> >
> > here is a proposal on how to resolve the missing documentation for
> 10.0.0.
> > I think I have a working MVP in a form of pull-request on website so I
> > think it
> > is a good time to get more feedback.
> > You can also vote if you consider this good enough.
> >
> > I also call to arms the SME's of Drools, Kogito & JBPM, I need your help!
> >
> > Github Issue -
> https://github.com/apache/incubator-kie-issues/issues/1803
> > Pull-request for website -
> > https://github.com/apache/incubator-kie-website/pull/18
> >
> > *Summary*
> >
> > Fix missing documentation guides for 10.0.0 release by updating, building
> > the individual docs in (incubator-kie-drools, incubator-kie-kogito-docs,
> > incubator-kie-docs) and including them as static content into the current
> > website.
> >
> > *Details*
> > A new sidebar called Documentation is created with references to Main and
> > Release streams.
> > Main page will summarize development and common information.
> > Release stream pages will showcase each component as Chapter.
> > The individual docs will be included as IFRAME referencing the content in
> > static
> > A workflow action will be modified to:
> > 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> > 2. Build each
> > 3. Checkout website
> > 4. Copy built docs into the website static folder
> > 5. Build site
> > 6. Deploy site
> >
> > *Status*
> > I am sharing the updates in the github issue,short summary here:
> > * Sonataflow is ready, we might still need to review the compliance to
> > apache guidelines.
> > * Kogito and JBPM are stalled in this PR -
> > https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an SME
> > here so I urge everyone again to help.
> > * Drools had docs moved away from 10.0.x, if someone from SME's can
> > reinstate them and take care of this let me know. I will just include the
> > steps in the workflow to deploy the website.
> >
> > *Goals*
> > Update docs for each component to 10.0.0.
> > Include them in the website deploy process for 10.0.0
> > Deploy new content for 10.0.0
> >
> > Let me know what you think, I also suggest to provide feedback directly
> on
> > PR's
> >
> >
> > Best regards,
> >
> > Dominik
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@kie.apache.org
> For additional commands, e-mail: dev-help@kie.apache.org
>
>
Re: [PROPOSAL] Fix missing documentation for 10.0.0
Posted by Yeser Amer <ya...@apache.org>.
+1
On 2025/02/06 11:47:39 Dominik Hanak wrote:
> Hello Community,
>
> here is a proposal on how to resolve the missing documentation for 10.0.0.
> I think I have a working MVP in a form of pull-request on website so I
> think it
> is a good time to get more feedback.
> You can also vote if you consider this good enough.
>
> I also call to arms the SME's of Drools, Kogito & JBPM, I need your help!
>
> Github Issue - https://github.com/apache/incubator-kie-issues/issues/1803
> Pull-request for website -
> https://github.com/apache/incubator-kie-website/pull/18
>
> *Summary*
>
> Fix missing documentation guides for 10.0.0 release by updating, building
> the individual docs in (incubator-kie-drools, incubator-kie-kogito-docs,
> incubator-kie-docs) and including them as static content into the current
> website.
>
> *Details*
> A new sidebar called Documentation is created with references to Main and
> Release streams.
> Main page will summarize development and common information.
> Release stream pages will showcase each component as Chapter.
> The individual docs will be included as IFRAME referencing the content in
> static
> A workflow action will be modified to:
> 1. Checkout drools, sonataflow, jbpm, kogito docs repositories
> 2. Build each
> 3. Checkout website
> 4. Copy built docs into the website static folder
> 5. Build site
> 6. Deploy site
>
> *Status*
> I am sharing the updates in the github issue,short summary here:
> * Sonataflow is ready, we might still need to review the compliance to
> apache guidelines.
> * Kogito and JBPM are stalled in this PR -
> https://github.com/apache/incubator-kie-docs/pull/4538 - I am not an SME
> here so I urge everyone again to help.
> * Drools had docs moved away from 10.0.x, if someone from SME's can
> reinstate them and take care of this let me know. I will just include the
> steps in the workflow to deploy the website.
>
> *Goals*
> Update docs for each component to 10.0.0.
> Include them in the website deploy process for 10.0.0
> Deploy new content for 10.0.0
>
> Let me know what you think, I also suggest to provide feedback directly on
> PR's
>
>
> Best regards,
>
> Dominik
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@kie.apache.org
For additional commands, e-mail: dev-help@kie.apache.org