<div dir="ltr">I&#39;d rather just add it to our documentation, which is available at <a href="http://keycloak.org/docs">keycloak.org/docs</a> so don&#39;t see any reason to use yet another thing.</div><div class="gmail_extra"><br><div class="gmail_quote">On 25 February 2016 at 13:50, Marko Strukelj <span dir="ltr">&lt;<a href="mailto:mstrukel@redhat.com" target="_blank">mstrukel@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Maybe it would be good to use GitHub&#39;s Releases for release notes as that&#39;s a standard place people are used to look at - e.g.: <a href="https://github.com/openshift/origin/releases" target="_blank">https://github.com/openshift/origin/releases</a>.</div><div><br></div><div>But it could also be next to any download link - <a href="http://keycloak.jboss.org/downloads" target="_blank">http://keycloak.jboss.org/downloads</a> could contain a README.TXT with link to GitHub&#39;s Releases, for example.<br></div></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Feb 25, 2016 at 12:45 PM, Bruno Oliveira <span dir="ltr">&lt;<a href="mailto:bruno@abstractj.org" target="_blank">bruno@abstractj.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">+1<br></div><div><div><br><div class="gmail_quote"><div dir="ltr">On Thu, Feb 25, 2016 at 8:05 AM Stian Thorgersen &lt;<a href="mailto:sthorger@redhat.com" target="_blank">sthorger@redhat.com</a>&gt; wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">What I&#39;m going to do is:<div><br></div><div>* Short term - start mentioning important migration issues in release announcement and link to migration doc</div><div>* Long term - start creating proper release notes and include in documentation, release announcement in the future will just be highlights and link to this</div><div><br></div><div>Comments?</div></div><div class="gmail_extra"><br><div class="gmail_quote">On 25 February 2016 at 11:36, Edgar Vonk - Info.nl <span dir="ltr">&lt;<a href="mailto:Edgar@info.nl" target="_blank">Edgar@info.nl</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">



<div style="word-wrap:break-word">
that would certainly help indeed!
<div><br>
</div>
<div>as an example this is how Magnolia (a Java CMS we often use in our projects) does it:</div>
<div><a href="https://forums.magnolia-cms.com/forum/thread.html?threadId=5f23d559-16be-4637-b3a5-dcb8dddc24c1#41e491fa-7abf-4c92-ae97-063c75895db5" target="_blank">https://forums.magnolia-cms.com/forum/thread.html?threadId=5f23d559-16be-4637-b3a5-dcb8dddc24c1#41e491fa-7abf-4c92-ae97-063c75895db5</a></div>
<div><br>
</div>
<div>I think they removed it now but they even had a automatically generated section in their release notes with a list of people who ‘contributed’ by reporting issues in JIRA that were fixed in the release. A way to attach your users to your product
 I guess.</div><div><div>
<div> </div>
<div><br>
<div>
<blockquote type="cite">
<div>On 25 Feb 2016, at 11:24, Marek Posolda &lt;<a href="mailto:mposolda@redhat.com" target="_blank">mposolda@redhat.com</a>&gt; wrote:</div>
<br>
<div>
<div bgcolor="#FFFFFF" text="#000000">
<div>Maybe the best chance people won&#39;t miss it, is to put the note into release announcement? Just something high level like &quot;We changed location of themes and did some other changes XYZ. Don&#39;t forget to read migration guide for more
 details&quot; or something like that?<br>
<br>
Marek<br>
<br>
On 25/02/16 10:28, Stian Thorgersen wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">Bruno: No need to update theme chapter - Marc from APIMan is already on the task :)
<div><br>
</div>
<div>&quot;Before you get started&quot; will that be read though? I can&#39;t see current users reading that.</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On 25 February 2016 at 10:25, Bruno Oliveira <span dir="ltr">
&lt;<a href="mailto:bruno@abstractj.org" target="_blank">bruno@abstractj.org</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">I will review the whole theme chapter today and see if I find any mismatches.
<div><br>
</div>
<div>Regarding your question, I&#39;d add a section in the very beginning of our guide called &quot;Before you get started&quot;.</div>
</div>
<div>
<div><br>
<div class="gmail_quote">
<div dir="ltr">On Thu, Feb 25, 2016 at 6:23 AM Stian Thorgersen &lt;<a href="mailto:sthorger@redhat.com" target="_blank">sthorger@redhat.com</a>&gt; wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">Any tips on how we can make it more obvious to users to read the migration guide?</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On 25 February 2016 at 10:21, Edgar Vonk - <a href="http://info.nl" target="_blank">
Info.nl</a> <span dir="ltr">&lt;<a href="mailto:Edgar@info.nl" target="_blank"></a><a href="mailto:Edgar@info.nl" target="_blank">Edgar@info.nl</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div style="word-wrap:break-word">ok, thanks! you are right, I should have read the migration guide. 
<div>
<div>
<div><br>
<div>
<blockquote type="cite">
<div>On 25 Feb 2016, at 10:19, Stian Thorgersen &lt;<a href="mailto:sthorger@redhat.com" target="_blank"></a><a href="mailto:sthorger@redhat.com" target="_blank">sthorger@redhat.com</a>&gt; wrote:</div>
<br>
<div>
<div dir="ltr">Yes, it has moved. I forgot to update the themes doc, but it&#39;s included in the migration guide.
<div><br>
</div>
<div>Always read the migration guide before upgrading! It will quite likely save you a lot of time.</div>
<div><a href="http://keycloak.github.io/docs/userguide/keycloak-server/html/Migration_from_older_versions.html#d4e3997" target="_blank">http://keycloak.github.io/docs/userguide/keycloak-server/html/Migration_from_older_versions.html#d4e3997</a><br>
</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On 25 February 2016 at 10:00, Thomas Darimont <span dir="ltr">
&lt;<a href="mailto:thomas.darimont@googlemail.com" target="_blank"></a><a href="mailto:thomas.darimont@googlemail.com" target="_blank">thomas.darimont@googlemail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">This was discussed a few days ago on the dev list:
<div><a href="http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html" target="_blank"></a><a href="http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html" target="_blank">http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html</a><br>
</div>
<div><br>
</div>
<div>Perhaphs there should have sent a mail to the user-list as well...</div>
<div><br>
</div>
<div>Cheers,</div>
<div>Thomas</div>
</div>
<div>
<div>
<div class="gmail_extra"><br>
<div class="gmail_quote">2016-02-25 9:31 GMT+01:00 Edgar Vonk - <a href="http://info.nl/" target="_blank">
Info.nl</a> <span dir="ltr">&lt;<a href="mailto:Edgar@info.nl" target="_blank"></a><a href="mailto:Edgar@info.nl" target="_blank">Edgar@info.nl</a>&gt;</span>:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi,<br>
<br>
It seems that the themes folder has moved in Keycloak 1.9.0.Final (from 1.9.0.RC1)?<br>
<br>
The themes folder used to be:<br>
$KEYCLOAK_HOME/standalone/configuration/themes<br>
<br>
but now it seems to be:<br>
$KEYCLOAK_HOME/themes<br>
<br>
The documentation still mentions the old location so I think needs to be updated?<br>
<a href="http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html#d4e2431" rel="noreferrer" target="_blank"></a><a href="http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html#d4e2431" target="_blank">http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html#d4e2431</a><br>
<br>
cheers<br>
<br>
Edgar<br>
_______________________________________________<br>
keycloak-user mailing list<br>
<a href="mailto:keycloak-user@lists.jboss.org" target="_blank"></a><a href="mailto:keycloak-user@lists.jboss.org" target="_blank">keycloak-user@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/keycloak-user" rel="noreferrer" target="_blank"></a><a href="https://lists.jboss.org/mailman/listinfo/keycloak-user" target="_blank">https://lists.jboss.org/mailman/listinfo/keycloak-user</a><br>
</blockquote>
</div>
<br>
</div>
</div>
</div>
<br>
_______________________________________________<br>
keycloak-user mailing list<br>
<a href="mailto:keycloak-user@lists.jboss.org" target="_blank">keycloak-user@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/keycloak-user" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/keycloak-user</a><br>
</blockquote>
</div>
<br>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<br>
</div>
_______________________________________________<br>
keycloak-user mailing list<br>
<a href="mailto:keycloak-user@lists.jboss.org" target="_blank">keycloak-user@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/keycloak-user" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/keycloak-user</a></blockquote>
</div>
</div>
</div>
</blockquote>
</div>
<br>
</div>
<br>
<fieldset></fieldset> <br>
<pre>_______________________________________________
keycloak-user mailing list
<a href="mailto:keycloak-user@lists.jboss.org" target="_blank">keycloak-user@lists.jboss.org</a>
<a href="https://lists.jboss.org/mailman/listinfo/keycloak-user" target="_blank">https://lists.jboss.org/mailman/listinfo/keycloak-user</a></pre>
</blockquote>
<br>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</div></div></div>

</blockquote></div><br></div>
</blockquote></div>
</div></div><br>_______________________________________________<br>
keycloak-user mailing list<br>
<a href="mailto:keycloak-user@lists.jboss.org" target="_blank">keycloak-user@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/keycloak-user" rel="noreferrer" target="_blank">https://lists.jboss.org/mailman/listinfo/keycloak-user</a><br></blockquote></div><br></div>
</div></div></blockquote></div><br></div>