<div dir="ltr"><div>Hey guys,</div><div><br></div><div>TL;DR</div><div>I&#39;ve converted confluence docs asciidoc [1] [2] ones that will be part of WildFly codebase, </div><div>take a look at them and let me know if there are any big issues.<br></div><div><br></div><div><br></div><div>----</div><div>full version:</div><div><br></div><div>as most of you already know, I was working on moving our confluence based [1] documentation to asciidoc based one.</div><div><br></div><div>result can be seen at [7] or rendered to html at [8]<br></div><div><br></div><div>A good side effect of conversion is that now docs are also browsable directly on GitHub.</div><div>For example [2] or [3] <br></div><div><br></div><div>Currently I kept same structure as we had in confluence, which in practice means</div><div>we have set of &quot;guides&quot; that than have lots of sub pages / includes that produce &quot;big&quot; guides.</div><div>Currently such guides are:</div><div>- Admin Guide</div><div>- Developer Guide</div><div>- Getting started guide</div><div>- Getting Started Developing Applications Guide</div><div>- High Availability Guide</div><div>- Extending WildFly guide</div><div>- JavaEE 7(6 actually) Tutorial</div><div>- Elytron security guide</div><div>- quickstarts</div><div>- Testsuite<br></div><div><br></div><div>Problem is that some of this guide as such make sense, but not all of them do.</div><div>In some cases we have duplicated docs for same thing, in others we content in wrong segment.</div><div>For example instead of having all subsystem reference docs under admin guide, </div><div>some are under Developer Guide and some even under HA guide.</div><div><br></div><div>Going forward we should &quot;refactor&quot; docs a bit, so we would end up with 3-4 high quality guides.</div><div>We should also go trough all docs and remove/update the outdated content.</div><div><br></div><div>Plan is also to have documentation now part of WildFly codebase.</div><div>So when we would submit PR with new feature, it would also include documentation for it as well.</div><div><br></div><div>Rendered docs can be build as part of our build / release process and can be rendered to different formats.</div><div>for example default is HTML [5] or PDF [6]</div><div><br></div><div>I&#39;ve send experimental PR to show how docs would fit into WildFly build [4]</div><div><br></div><div>Please take look at current docs and if you have any comments / suggestions what we can improve before merging it let me know.</div><div>At this point I&#39;ve not done much content-wise changes but just conversion + formatting ones. </div><div>Content updates can come after this is merged.</div><div><br></div><div>--</div><div>tomaz<br></div><div><br></div><div>[1] <a href="https://docs.jboss.org/author/display/WFLY/Documentation">https://docs.jboss.org/author/display/WFLY/Documentation</a></div><div>[2] <a href="https://github.com/ctomc/docs-playground/blob/master/admin-guide/Operating_modes.adoc">https://github.com/ctomc/docs-playground/blob/master/admin-guide/Operating_modes.adoc</a></div><div>[3] <a href="https://github.com/ctomc/docs-playground/blob/master/developer-guide/EJB3_Reference_Guide.adoc">https://github.com/ctomc/docs-playground/blob/master/developer-guide/EJB3_Reference_Guide.adoc</a></div><div>[4] <a href="https://github.com/wildfly/wildfly/pull/10523">https://github.com/wildfly/wildfly/pull/10523</a></div><div>[5] <a href="https://ctomc.github.io/docs-playground/Admin_Guide.html">https://ctomc.github.io/docs-playground/Admin_Guide.html</a></div><div>[6] <a href="https://ctomc.github.io/docs-playground/Admin_Guide.pdf">https://ctomc.github.io/docs-playground/Admin_Guide.pdf</a></div><div>[7] <a href="https://github.com/ctomc/docs-playground">https://github.com/ctomc/docs-playground</a></div><div>[8] <a href="https://ctomc.github.io/docs-playground/">https://ctomc.github.io/docs-playground/</a></div></div>