<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
        {font-family:Wingdings;
        panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
        {font-family:"Cambria Math";
        panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0cm;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:#954F72;
        text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
        {mso-style-priority:34;
        margin-top:0cm;
        margin-right:0cm;
        margin-bottom:0cm;
        margin-left:36.0pt;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
.MsoChpDefault
        {mso-style-type:export-only;}
@page WordSection1
        {size:612.0pt 792.0pt;
        margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
        {page:WordSection1;}
/* List Definitions */
@list l0
        {mso-list-id:486409779;
        mso-list-type:hybrid;
        mso-list-template-ids:588433902 -1 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
        {mso-level-start-at:0;
        mso-level-number-format:bullet;
        mso-level-text:-;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Calibri",sans-serif;
        mso-fareast-font-family:"Times New Roman";}
@list l0:level2
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Courier New";}
@list l0:level3
        {mso-level-number-format:bullet;
        mso-level-text:\F0A7;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Wingdings;}
@list l0:level4
        {mso-level-number-format:bullet;
        mso-level-text:\F0B7;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Symbol;}
@list l0:level5
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Courier New";}
@list l0:level6
        {mso-level-number-format:bullet;
        mso-level-text:\F0A7;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Wingdings;}
@list l0:level7
        {mso-level-number-format:bullet;
        mso-level-text:\F0B7;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Symbol;}
@list l0:level8
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Courier New";}
@list l0:level9
        {mso-level-number-format:bullet;
        mso-level-text:\F0A7;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Wingdings;}
ol
        {margin-bottom:0cm;}
ul
        {margin-bottom:0cm;}
--></style></head><body lang=SL link=blue vlink="#954F72"><div class=WordSection1><p class=MsoNormal>I've updated PR <a href="https://github.com/wildfly/wildfly/pull/10523">https://github.com/wildfly/wildfly/pull/10523</a></p><p class=MsoNormal>That brings in converted confluence documentation.</p><p class=MsoNormal>It is synced with todays content in confluence.</p><p class=MsoNormal><o:p>&nbsp;</o:p></p><p class=MsoNormal>This is just a start, going forward we should</p><p class=MsoNormal><o:p>&nbsp;</o:p></p><ul style='margin-top:0cm' type=disc><li class=MsoListParagraph style='margin-left:0cm;mso-list:l0 level1 lfo1'>Split docs between core &amp; full</li><li class=MsoListParagraph style='margin-left:0cm;mso-list:l0 level1 lfo1'>Each subsystem could have docs folder that would be than agreggated </li><li class=MsoListParagraph style='margin-left:0cm;mso-list:l0 level1 lfo1'>Publish docs somewhere. Maybe use GH for start <a href="http://wildfly.github.io/">http://wildfly.github.io/</a></li><li class=MsoListParagraph style='margin-left:0cm;mso-list:l0 level1 lfo1'>Restrucutre docs into few books instead of what we have now.</li></ul><p class=MsoNormal><o:p>&nbsp;</o:p></p><p class=MsoNormal>--</p><p class=MsoNormal>tomaz</p><p class=MsoNormal><o:p>&nbsp;</o:p></p><p class=MsoNormal><o:p>&nbsp;</o:p></p><div style='mso-element:para-border-div;border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0cm 0cm 0cm'><p class=MsoNormal style='border:none;padding:0cm'><b>From: </b><a href="mailto:bmcwhirt@redhat.com">Bob McWhirter</a><br><b>Sent: </b>četrtek, 09. november 2017 01:48<br><b>To: </b><a href="mailto:brian.stansberry@redhat.com">Brian Stansberry</a><br><b>Cc: </b><a href="mailto:wildfly-dev@lists.jboss.org">wildfly-dev@lists.jboss.org</a><br><b>Subject: </b>Re: [wildfly-dev] WildFly asciidoc based documentation</p></div><p class=MsoNormal><o:p>&nbsp;</o:p></p><div><div><p class=MsoNormal>We have recent used he doc teams “modular documentation templates” and I think they are lovely and also makes the docs team happy.&nbsp;</p></div><div><p class=MsoNormal><o:p>&nbsp;</o:p></p></div><div><p class=MsoNormal>Ask your doctor if modular documentation templates are right for you.&nbsp;</p></div><div><p class=MsoNormal><o:p>&nbsp;</o:p></p></div><div><p class=MsoNormal>Bob</p></div><p class=MsoNormal><o:p>&nbsp;</o:p></p><div><div><p class=MsoNormal>On Wed, Nov 8, 2017 at 12:40 PM Brian Stansberry &lt;<a href="mailto:brian.stansberry@redhat.com">brian.stansberry@redhat.com</a>&gt; wrote:</p></div><blockquote style='border:none;border-left:solid #CCCCCC 1.0pt;padding:0cm 0cm 0cm 6.0pt;margin-left:4.8pt;margin-right:0cm'><div><p class=MsoNormal>Sounds like a good goal, but I don't think Tomaz should be responsible for correcting all our docs to make them conform. For many of these I doubt the Confluence markup includes relevant metadata that would have allowed that (e.g. that a given literal was a filename, hence [filename]`thename` instead of `thename`. We'd need to assign owners to various pages and have them correct them. An obvious initial owner being the component lead for the component that's most relevant to the page.</p></div><div><p class=MsoNormal><o:p>&nbsp;</o:p></p><div><p class=MsoNormal>On Wed, Nov 8, 2017 at 7:04 AM, David Lloyd &lt;<a href="mailto:david.lloyd@redhat.com" target="_blank">david.lloyd@redhat.com</a>&gt; wrote:</p><blockquote style='border:none;border-left:solid #CCCCCC 1.0pt;padding:0cm 0cm 0cm 6.0pt;margin-left:4.8pt;margin-right:0cm'><p class=MsoNormal>I would suggest that we ensure that our produced AsciiDoc files<br>conform to [1] (generated from [2]).&nbsp; Beyond that, I support this<br>initiative wholeheartedly.<br><br>[1] <a href="https://redhat-documentation.github.io/asciidoc-markup-conventions/" target="_blank">https://redhat-documentation.github.io/asciidoc-markup-conventions/</a><br>[2] <a href="https://github.com/redhat-documentation/asciidoc-markup-conventions" target="_blank">https://github.com/redhat-documentation/asciidoc-markup-conventions</a></p><div><div><p class=MsoNormal><br>On Tue, Nov 7, 2017 at 12:06 PM, Brian Stansberry<br>&lt;<a href="mailto:brian.stansberry@redhat.com" target="_blank">brian.stansberry@redhat.com</a>&gt; wrote:<br>&gt; Since we're done with WF 11, I think it's time to move forward on this.<br>&gt; There's still some discussion to have about decomposing the docs so the<br>&gt; relevant doc bits are aligned with the feature packs they come from, but I<br>&gt; haven't heard any argument against moving off Confluence and having the docs<br>&gt; included in the source tree. Since we don't have the current docs decomposed<br>&gt; in any way, I see no reason not to go ahead with bringing the docs in<br>&gt; wildfly/wildfly master and then we can deal with decomposition as a later<br>&gt; step.<br>&gt;<br>&gt; On Tue, Sep 19, 2017 at 7:58 AM, Tomaž Cerar &lt;<a href="mailto:tomaz.cerar@gmail.com" target="_blank">tomaz.cerar@gmail.com</a>&gt; wrote:<br>&gt;&gt;<br>&gt;&gt; Hey guys,<br>&gt;&gt;<br>&gt;&gt; TL;DR<br>&gt;&gt; I've converted confluence docs asciidoc [1] [2] ones that will be part of<br>&gt;&gt; WildFly codebase,<br>&gt;&gt; take a look at them and let me know if there are any big issues.<br>&gt;&gt;<br>&gt;&gt;<br>&gt;&gt; ----<br>&gt;&gt; full version:<br>&gt;&gt;<br>&gt;&gt; as most of you already know, I was working on moving our confluence based<br>&gt;&gt; [1] documentation to asciidoc based one.<br>&gt;&gt;<br>&gt;&gt; result can be seen at [7] or rendered to html at [8]<br>&gt;&gt;<br>&gt;&gt; A good side effect of conversion is that now docs are also browsable<br>&gt;&gt; directly on GitHub.<br>&gt;&gt; For example [2] or [3]<br>&gt;&gt;<br>&gt;&gt; Currently I kept same structure as we had in confluence, which in practice<br>&gt;&gt; means<br>&gt;&gt; we have set of &quot;guides&quot; that than have lots of sub pages / includes that<br>&gt;&gt; produce &quot;big&quot; guides.<br>&gt;&gt; Currently such guides are:<br>&gt;&gt; - Admin Guide<br>&gt;&gt; - Developer Guide<br>&gt;&gt; - Getting started guide<br>&gt;&gt; - Getting Started Developing Applications Guide<br>&gt;&gt; - High Availability Guide<br>&gt;&gt; - Extending WildFly guide<br>&gt;&gt; - JavaEE 7(6 actually) Tutorial<br>&gt;&gt; - Elytron security guide<br>&gt;&gt; - quickstarts<br>&gt;&gt; - Testsuite<br>&gt;&gt;<br>&gt;&gt; Problem is that some of this guide as such make sense, but not all of them<br>&gt;&gt; do.<br>&gt;&gt; In some cases we have duplicated docs for same thing, in others we content<br>&gt;&gt; in wrong segment.<br>&gt;&gt; For example instead of having all subsystem reference docs under admin<br>&gt;&gt; guide,<br>&gt;&gt; some are under Developer Guide and some even under HA guide.<br>&gt;&gt;<br>&gt;&gt; Going forward we should &quot;refactor&quot; docs a bit, so we would end up with 3-4<br>&gt;&gt; high quality guides.<br>&gt;&gt; We should also go trough all docs and remove/update the outdated content.<br>&gt;&gt;<br>&gt;&gt; Plan is also to have documentation now part of WildFly codebase.<br>&gt;&gt; So when we would submit PR with new feature, it would also include<br>&gt;&gt; documentation for it as well.<br>&gt;&gt;<br>&gt;&gt; Rendered docs can be build as part of our build / release process and can<br>&gt;&gt; be rendered to different formats.<br>&gt;&gt; for example default is HTML [5] or PDF [6]<br>&gt;&gt;<br>&gt;&gt; I've send experimental PR to show how docs would fit into WildFly build<br>&gt;&gt; [4]<br>&gt;&gt;<br>&gt;&gt; Please take look at current docs and if you have any comments /<br>&gt;&gt; suggestions what we can improve before merging it let me know.<br>&gt;&gt; At this point I've not done much content-wise changes but just conversion<br>&gt;&gt; + formatting ones.<br>&gt;&gt; Content updates can come after this is merged.<br>&gt;&gt;<br>&gt;&gt; --<br>&gt;&gt; tomaz<br>&gt;&gt;<br>&gt;&gt; [1] <a href="https://docs.jboss.org/author/display/WFLY/Documentation" target="_blank">https://docs.jboss.org/author/display/WFLY/Documentation</a><br>&gt;&gt; [2]<br>&gt;&gt; <a href="https://github.com/ctomc/docs-playground/blob/master/admin-guide/Operating_modes.adoc" target="_blank">https://github.com/ctomc/docs-playground/blob/master/admin-guide/Operating_modes.adoc</a><br>&gt;&gt; [3]<br>&gt;&gt; <a href="https://github.com/ctomc/docs-playground/blob/master/developer-guide/EJB3_Reference_Guide.adoc" target="_blank">https://github.com/ctomc/docs-playground/blob/master/developer-guide/EJB3_Reference_Guide.adoc</a><br>&gt;&gt; [4] <a href="https://github.com/wildfly/wildfly/pull/10523" target="_blank">https://github.com/wildfly/wildfly/pull/10523</a><br>&gt;&gt; [5] <a href="https://ctomc.github.io/docs-playground/Admin_Guide.html" target="_blank">https://ctomc.github.io/docs-playground/Admin_Guide.html</a><br>&gt;&gt; [6] <a href="https://ctomc.github.io/docs-playground/Admin_Guide.pdf" target="_blank">https://ctomc.github.io/docs-playground/Admin_Guide.pdf</a><br>&gt;&gt; [7] <a href="https://github.com/ctomc/docs-playground" target="_blank">https://github.com/ctomc/docs-playground</a><br>&gt;&gt; [8] <a href="https://ctomc.github.io/docs-playground/" target="_blank">https://ctomc.github.io/docs-playground/</a><br>&gt;&gt;<br>&gt;&gt; _______________________________________________<br>&gt;&gt; wildfly-dev mailing list<br>&gt;&gt; <a href="mailto:wildfly-dev@lists.jboss.org" target="_blank">wildfly-dev@lists.jboss.org</a><br>&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/wildfly-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/wildfly-dev</a><br>&gt;<br>&gt;<br>&gt;<br>&gt;<br>&gt; --<br>&gt; Brian Stansberry<br>&gt; Manager, Senior Principal Software Engineer<br>&gt; Red Hat<br>&gt;<br>&gt; _______________________________________________<br>&gt; wildfly-dev mailing list<br>&gt; <a href="mailto:wildfly-dev@lists.jboss.org" target="_blank">wildfly-dev@lists.jboss.org</a><br>&gt; <a href="https://lists.jboss.org/mailman/listinfo/wildfly-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/wildfly-dev</a><br><br><br><br>--</p></div></div><p class=MsoNormal>- DML</p></blockquote></div><p class=MsoNormal><br><br clear=all></p><div><p class=MsoNormal><o:p>&nbsp;</o:p></p></div><p class=MsoNormal>-- </p><div><div><p class=MsoNormal>Brian Stansberry</p><div><p class=MsoNormal>Manager, Senior Principal Software Engineer</p></div><div><p class=MsoNormal>Red Hat</p></div></div></div></div></blockquote></div></div><p class=MsoNormal style='margin-left:4.8pt'>_______________________________________________<br>wildfly-dev mailing list<br><a href="mailto:wildfly-dev@lists.jboss.org" target="_blank">wildfly-dev@lists.jboss.org</a><br><a href="https://lists.jboss.org/mailman/listinfo/wildfly-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/wildfly-dev</a></p><p class=MsoNormal><o:p>&nbsp;</o:p></p></div></body></html>