Hello, I can play the outsider perspective role for this RFE, Jeff, so count on me for this task. Regards On Fri, Jun 20, 2025 at 10:13 AM Jeff Mesnil via wildfly-dev < wildfly-dev(a)lists.jboss.org&gt; wrote:

Hi, Here is an update on that proposal[1] after your feedback (thanks!). I’ve a prototype of the RFE[2] that is good enough to give a broad idea of the finished feature. It is using a new documentation generator that supersedes WildScribe and use Qute for its template engine. The impact for feature pack developers is minimal, they will have to bump the galleon-plugins version and that’s it. To make it more visual, I applied the changes to WildFly itself and the diff is minimal[3] (including the changes to the doc module of WildFly & the removal of the Wildscribe dependency). WildFly is a special case as we want to have a single documentation entry point while we have 2 feature packs (wildfly-galleon-pack & wildfly-ee-galleon-pack). For this special case, we generates the documentation from the feature pack *and its dependencies*. For other feature packs, there will be nothing to do. I generated this doc and pushes it to my fork of docs.wildfly.org at https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/reference/ [4] For reference, the existing doc is at https://docs.wildfly.org/37/wildscribe/index.html It’s not feature complete (log codes and capabilities are missing) but it’s good enough to give you an idea. In particular, it shows the following improvements: * All subsystems are described (eg microprofile-reactive-messaging-smallrye is missing in the current doc) * Each attribute and operations can display their raw DMR model in addition to the elements presented in the UI (that proves useful for complex attributes or operations). * There is some information that is not displayed by wildscribe (eg “alternatives") that is visible in the raw DMR model if we don’t want to surface it to the UI... * Current: https://docs.wildfly.org/37/wildscribe/subsystem/messaging-activemq/conne... * New https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/reference... * most importantly, this doc comes for free for any feature pack (cloud, datasources, grpc, ai, etc.) As a part of this RFE, I also want to generate doc about the feature pack itself: https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/index.html This offers interesting information such as: * the maven dependency to provision the feature pack * general information (description, licenses, source control) * layer information (including their dependencies, packages & properties) * that would complement or replace our handcrafted doc at https://docs.wildfly.org/37/Galleon_Guide.html#wildfly_layers & https://docs.wildfly.org/wildfly-galleon-feature-packs/#_support_for_wild... The feature pack doc needs a bit more polish but the generation of the model reference should soon be good enough to be usable. This would be part of a major bump of our Galleon plugins (there is plenty of major features coming up in them). I’ll finish the model reference to be on par (and above) with wildscribe. Please have a look at the output at [1] and provide any feedback to the proposal at [4]. Thanks, Jeff [1] https://github.com/jmesnil/wildfly-proposals/blob/WFGP-292_doc_galleon-pa... [2] https://github.com/jmesnil/galleon-plugins/tree/fp-metadata [3] https://github.com/wildfly/wildfly/compare/main...jmesnil:wildfly:feature... [4] https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/reference/ -- Jeff Mesnil Engineer @ Red Hat http://jmesnil.net/

Hi, This feature is completed and I’ve merged the proposal. It is now published at http://docs.wildfly.org/wildfly-proposals/provisioning/WFGP-292_doc_galle... We have started to update our feature pack to generate their documentation (that is done through a bump to Galleon Maven Plugins 8.0.0.Final). As an example, the gRPC feature pack was updated in https://github.com/wildfly-extras/wildfly-grpc-feature-pack/pull/356 Changes are minimal (updating the pom.xml name & description + adding some properties to better describe the layers). I’ve also opened a PR for WildFly (targeting WildFly 39) at https://github.com/wildfly/wildfly/pull/19265 that replaces the model reference generated by WildScribe in the docs and instead leverage this new doc.zip. To see the new doc, build WildFly and open docs/target/generated-docs/feature-pack/doc/index.html I’ve fixed the links in our guides and refines them to point to the actual Management API Reference instead of the root page. This does not change the way we are publishing our docs in docs.wildfly.org upon release. Best regards, Jeff On 30 Sep 2025, at 10:28, Jean-Frederic Mesnil via wildfly-dev <wildfly-dev(a)lists.jboss.org&gt; wrote: This Message Is From an External Sender This message came from outside your organization. <https://us-phishalarm-ewt.proofpoint.com/EWT/v1/AdhS1Rd-!9DFbvBYycmH71bbY... Report Suspicious Hi, The development for this feature is done and we’re planning to get it for WildFly 39 (that’s too late for 38). It’s a full replacement for what Wildscribe was providing plus a lot of other information about feature packs & layers. The proposal[1] contains all the information about this feature and I applied tjhis feature to WildFly itself and the result can be seen at: https://jmesnil.github.io/wildfly.github.io/38/feature-pack/doc/<https... > More interestingly, I also generated the doc for the gRPC feature pack[2] and this creates a full new set of documentation that we do not have at the moment: https://jmesnil.github.io/wildfly-grpc-feature-pack/<https://jmesnil.g... > Cheers, Jeff [1] https://github.com/wildfly/wildfly-proposals/pull/739<https://github.c... > [2] https://github.com/wildfly-extras/wildfly-grpc-feature-pack<https://gi... > On 17 Sep 2025, at 17:05, Jeff Mesnil via wildfly-dev <wildfly-dev@lists.jboss.org<mailto:wildfly-dev@lists.jboss.org>> wrote: Hi, Here is an update on that proposal[1] after your feedback (thanks!). I’ve a prototype of the RFE[2] that is good enough to give a broad idea of the finished feature. It is using a new documentation generator that supersedes WildScribe and use Qute for its template engine. The impact for feature pack developers is minimal, they will have to bump the galleon-plugins version and that’s it. To make it more visual, I applied the changes to WildFly itself and the diff is minimal[3] (including the changes to the doc module of WildFly & the removal of the Wildscribe dependency). WildFly is a special case as we want to have a single documentation entry point while we have 2 feature packs (wildfly-galleon-pack & wildfly-ee-galleon-pack). For this special case, we generates the documentation from the feature pack *and its dependencies*. For other feature packs, there will be nothing to do. I generated this doc and pushes it to my fork of docs.wildfly.org<http://docs.wildfly.org/> at https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/reference/ [4] For reference, the existing doc is at https://docs.wildfly.org/37/wildscribe/index.html It’s not feature complete (log codes and capabilities are missing) but it’s good enough to give you an idea. In particular, it shows the following improvements: * All subsystems are described (eg microprofile-reactive-messaging-smallrye is missing in the current doc) * Each attribute and operations can display their raw DMR model in addition to the elements presented in the UI (that proves useful for complex attributes or operations). * There is some information that is not displayed by wildscribe (eg “alternatives") that is visible in the raw DMR model if we don’t want to surface it to the UI... * Current: https://docs.wildfly.org/37/wildscribe/subsystem/messaging-activemq/conne... * New https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/reference... * most importantly, this doc comes for free for any feature pack (cloud, datasources, grpc, ai, etc.) As a part of this RFE, I also want to generate doc about the feature pack itself: https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/index.html This offers interesting information such as: * the maven dependency to provision the feature pack * general information (description, licenses, source control) * layer information (including their dependencies, packages & properties) * that would complement or replace our handcrafted doc at https://docs.wildfly.org/37/Galleon_Guide.html#wildfly_layers & https://docs.wildfly.org/wildfly-galleon-feature-packs/#_support_for_wild... The feature pack doc needs a bit more polish but the generation of the model reference should soon be good enough to be usable. This would be part of a major bump of our Galleon plugins (there is plenty of major features coming up in them). I’ll finish the model reference to be on par (and above) with wildscribe. Please have a look at the output at [1] and provide any feedback to the proposal at [4]. Thanks, Jeff [1] https://github.com/jmesnil/wildfly-proposals/blob/WFGP-292_doc_galleon-pa... [2] https://github.com/jmesnil/galleon-plugins/tree/fp-metadata [3] https://github.com/wildfly/wildfly/compare/main...jmesnil:wildfly:feature... [4] https://jmesnil.github.io/wildfly.github.io/37/feature-pack/doc/reference/ On 20 Jun 2025, at 15:57, Jeff Mesnil <jmesnil@redhat.com<mailto:jmesnil@redhat.com>> wrote: Thanks Yeray, We have a feature team so we can proceed with the planning phase and review the proposal: https://github.com/wildfly/wildfly-proposals/pull/739 Cheers, Jeff On 20 Jun 2025, at 12:43, Yeray Borges Santana <yborgess@redhat.com<mailto:yborgess@redhat.com>> wrote: Hello, I can play the outsider perspective role for this RFE, Jeff, so count on me for this task. Regards On Fri, Jun 20, 2025 at 10:13 AM Jeff Mesnil via wildfly-dev <wildfly-dev@lists.jboss.org<mailto:wildfly-dev@lists.jboss.org>> wrote: Hi, I’ve created a proposal[1] to generate a documentation archive when a feature pack is created (similar to the javadoc archive that is generated when a Java jar is built by Maven) I’m looking for a feature team to work on this proposal. Jean-Francois and Emmanuel already provided some PoC around this idea so I nominated you as SMEs :) But I’d need another outside perspective to fully form the team. This RFE does not impact the runtime so stability level is not directly applicable but I aim to do something equivalent to the quality expected by the “community” stability level. Best regards, Jeff [1] https://github.com/wildfly/wildfly-proposals/pull/739 -- Jeff Mesnil Engineer @ Red Hat http://jmesnil.net/ _______________________________________________ wildfly-dev mailing list -- wildfly-dev@lists.jboss.org<mailto:wildfly-dev@lists.jboss.org> To unsubscribe send an email to wildfly-dev-leave@lists.jboss.org<mailto:wildfly-dev-leave@lists.jboss.org> Privacy Statement: https://www.redhat.com/en/about/privacy-policy List Archives: https://lists.jboss.org/archives/list/wildfly-dev@lists.jboss.org/message... -- Jeff Mesnil Engineer @ Red Hat http://jmesnil.net/ -- Jeff Mesnil Engineer @ Red Hat http://jmesnil.net/ _______________________________________________ wildfly-dev mailing list -- wildfly-dev@lists.jboss.org<mailto:wildfly-dev@lists.jboss.org> To unsubscribe send an email to wildfly-dev-leave@lists.jboss.org<mailto:wildfly-dev-leave@lists.jboss.org> Privacy Statement: https://www.redhat.com/en/about/privacy-policy List Archives: https://lists.jboss.org/archives/list/wildfly-dev@lists.jboss.org/message... -- Jeff Mesnil Software Engineer Red Hat JBoss EAP http://jmesnil.net/<http://jmesnil.net/ > IBM Unless otherwise stated above: Compagnie IBM France Siège Social : 17, avenue de l'Europe, 92275 Bois-Colombes Cedex RCS Nanterre 552 118 465 Forme Sociale : S.A.S. Capital Social : 664 614 175,50 € SIRET : 552 118 465 03644 - Code NAF 6203Z _______________________________________________ wildfly-dev mailing list -- wildfly-dev@lists.jboss.org<mailto:wildfly-dev@lists.jboss.org> To unsubscribe send an email to wildfly-dev-leave@lists.jboss.org<mailto:wildfly-dev-leave@lists.jboss.org> Privacy Statement: https://www.redhat.com/en/about/privacy-policy List Archives: https://lists.jboss.org/archives/list/wildfly-dev@lists.jboss.org/message... -- Jeff Mesnil Software Engineer Red Hat JBoss EAP http://jmesnil.net/ IBM Unless otherwise stated above: Compagnie IBM France Siège Social : 17, avenue de l'Europe, 92275 Bois-Colombes Cedex RCS Nanterre 552 118 465 Forme Sociale : S.A.S. Capital Social : 664 614 175,50 € SIRET : 552 118 465 03644 - Code NAF 6203Z

On Wed, Sep 17, 2025 at 10:32 AM Jean-Frederic Mesnil via wildfly-dev < wildfly-dev(a)lists.jboss.org&gt; wrote: I just did. :) Thanks, Jeff. -- Brian Stansberry Architect, JBoss EAP WildFly Project Lead He/Him/His