<div dir="ltr">JIRA generates a lot of stuff. It&#39;s worth creating a quick list of what new features and significant changes that where done in a release.<div><br></div><div>No one suggested removing the migration guide.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On 25 February 2016 at 15:46, Bill Burke <span dir="ltr">&lt;<a href="mailto:bburke@redhat.com" target="_blank">bburke@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 bgcolor="#FFFFFF" text="#000000">
    Jira already generates &quot;proper&quot; release notes.  We still need the
    migration guide.<div><div class="h5"><br>
    <br>
    <div>On 2/25/2016 6:05 AM, Stian Thorgersen
      wrote:<br>
    </div>
    <blockquote type="cite">
      <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"></a><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"></a><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" 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" 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"></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>
                                                          </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>
      <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><span class="HOEnZb"><font color="#888888"><pre cols="72">-- 
Bill Burke
JBoss, a division of Red Hat
<a href="http://bill.burkecentral.com" target="_blank">http://bill.burkecentral.com</a></pre>
  </font></span></div>

<br>_______________________________________________<br>
keycloak-user mailing list<br>
<a href="mailto:keycloak-user@lists.jboss.org">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>