<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div class=""><blockquote type="cite" class=""><div class="">On 13 Jan 2015, at 04:27, Paul Gier <<a href="mailto:pgier@redhat.com" class="">pgier@redhat.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">On 01/07/2015 08:33 AM, Sande Gilda wrote:</span><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><blockquote type="cite" style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><br class="">On 01/07/2015 05:29 AM, Paul Robinson wrote:<br class=""><blockquote type="cite" class="">Paul,<br class=""><br class="">I think you are the right person for this, but I could be wrong…<br class=""><br class="">On JBoss Developer we index quickstarts for each product and render<br class="">some of the documentation (README.md, CONTRIBUTING.md, for example) on<br class="">the site. Here’s an<br class="">example:http://<a href="http://www.jboss.org/quickstarts/eap/contributing/" class="">www.jboss.org/quickstarts/eap/contributing/</a><br class=""><<a href="http://www-stg.jboss.org/pr/714/build/1464/quickstarts/eap/contributing/" class="">http://www-stg.jboss.org/pr/714/build/1464/quickstarts/eap/contributing/</a>>.<br class="">We index the latest release of each quickstart from the related<br class="">Quickstart repo in the JBoss Developer GitHub organisation. It’s<br class="">important that we index the release, as we know it has been QA’d<br class="">against the latest product GA on the site.<br class=""><br class="">However, there are several cases where broken links exist in the<br class="">documentation that we are indexing. Notice the ‘Fork’ link<br class="">on <a href="http://www.jboss.org/quickstarts/eap/contributing/" class="">http://www.jboss.org/quickstarts/eap/contributing/</a>. This is due to<br class="">a broken link in the source<br class="">content: <a href="https://github.com/jboss-developer/jboss-eap-quickstarts/blob/6.3.0.GA/CONTRIBUTING.md" class="">https://github.com/jboss-developer/jboss-eap-quickstarts/blob/6.3.0.GA/CONTRIBUTING.md</a>.<br class="">This is easy to fix at source, but we would need to wait for the next<br class="">quickstarts release (in this case EAP 6.4.0.GA) before JBoss Developer<br class="">can consume the fix. Broken links are bad for user experience and<br class="">adversely affect SEO, so we’d rather get them fixed sooner.<span class="Apple-converted-space"> </span><br class=""><br class=""></blockquote>The CONTRIBUTING guide was moved to a common location to make it easier<br class="">to maintain and share across products:<br class=""><a href="https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONTRIBUTING.md" class="">https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONTRIBUTING.md</a><br class=""><br class="">I moved quite a few files to the common location to make updates easier.<br class="">The list is here:<br class=""><a href="https://github.com/jboss-developer/jboss-developer-shared-resources/tree/master/guides" class="">https://github.com/jboss-developer/jboss-developer-shared-resources/tree/master/guides</a><br class=""><br class="">Since this file doesn't ship with a product, we can update it as needed.<br class=""><blockquote type="cite" class="">One solution would be to allow documentation only changes to be made<br class="">to quickstarts between releases. In the example above, we would create<br class="">a commit (fixing the broken link) on top of the 6.3.0.GA release<br class="">(https://github.com/jboss-developer/jboss-eap-quickstarts/releases/tag/6.3.0.GA)<br class="">and then tag it as a new release. I think we’d have to use some naming<br class="">convention to indicate it was just docs that changed. JBoss Developer<br class="">would then index the new tag in order to consume the fix.<br class=""></blockquote>Should we create a new branch for these issues, for example,<br class="">6.3.1-develop and 6.3.1? Is it possible to create a new quickstart<br class="">distribution after GA?<br class=""></blockquote><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">It's probably up to QA and PM whether we want to deliver an updated zip</span><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">with the patch stream (6.3.x). I think we don't do it now just because</span><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">they don't want the extra effort of testing it.</span> I think we're pretty</div></blockquote><blockquote type="cite" class=""><div class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">much free to do what we want in the git repo, so we could create a</span><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">maintenance branch, although I'm not sure how we share that with the</span><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">customers.</span><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""></div></blockquote><div class=""><br class=""></div><div class="">So how about we limit these changes to just documentation (no code fixes) and only to critical items like broken links. We make the changes in the JBoss Developer GitHub repo and consume these changes on the JBoss Developer site.</div><div class=""><br class=""></div><div class="">QA and PM can ship these updated QS if they want, with the patch releases of the product.</div><div class=""><br class=""></div><div class="">Customers can go to JBoss Developer for the latest fixes to the QS docs. If they really want a new release, that’s gone through QA, then they would need to take that up with whoever manages their contract (not sure on the process for that, but hopefully you get my point).</div><div class=""><br class=""></div><br class=""><blockquote type="cite" class=""><div class=""><br style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><blockquote type="cite" style="font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><blockquote type="cite" class=""><br class="">Is this the right thing to do?<br class=""><br class="">Paul.<br class=""><br class="">--<span class="Apple-converted-space"> </span><br class="">Paul Robinson<br class="">JBoss Developer Team Lead (<a href="http://www.jboss.org/" class="">www.jboss.org</a><span class="Apple-converted-space"> </span><<a href="http://www.jboss.org/" class="">http://www.jboss.org</a>>)<br class=""><br class="">Free/busy<br class="">info: <a href="https://www.google.com/calendar/embed?src=probinso%40redhat.com&ctz=Europe/London" class="">https://www.google.com/calendar/embed?src=probinso%40redhat.com&ctz=Europe/London</a><br class=""><br class="">JBoss, a Division of Red Hat<br class="">Registered in England and Wales under Company Registration No. 03798903<br class="">Directors:Michael Cunningham (US), Charles Peters (US), Matt Parson<br class="">(US), Paul Hickey (Ireland)<br class=""><br class=""><br class=""><br class="">_______________________________________________<br class="">jbossdeveloper mailing list<br class=""><a href="mailto:jbossdeveloper@lists.jboss.org" class="">jbossdeveloper@lists.jboss.org</a><br class=""><a href="https://lists.jboss.org/mailman/listinfo/jbossdeveloper" class="">https://lists.jboss.org/mailman/listinfo/jbossdeveloper</a></blockquote></blockquote></div></blockquote></div><br class=""><div apple-content-edited="true" class="">
<div style="orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class="Apple-interchange-newline">Paul.</div><div style="color: rgb(0, 0, 0); letter-spacing: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""></div><div style="color: rgb(0, 0, 0); letter-spacing: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">-- <br class="">Paul Robinson</div><div style="color: rgb(0, 0, 0); letter-spacing: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">JBoss Developer Team Lead (<a href="http://www.jboss.org" class="">www.jboss.org</a>)</div><div style="color: rgb(0, 0, 0); letter-spacing: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""></div><div style="orphans: auto; text-align: start; text-indent: 0px; widows: auto; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Free/busy info: <a href="https://www.google.com/calendar/embed?src=probinso%40redhat.com&ctz=Europe/London" class="">https://www.google.com/calendar/embed?src=probinso%40redhat.com&ctz=Europe/London</a><br class=""><br class="">JBoss, a Division of Red Hat<br class="">Registered in England and Wales under Company Registration No. 03798903<br class="">Directors:Michael Cunningham (US), Charles Peters (US), Matt Parson (US), Paul Hickey (Ireland)</div></div>
</div>
<br class=""></body></html>