<html>
  <head>
    <meta content="text/html; charset=windows-1252"
      http-equiv="Content-Type">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    Jira already generates "proper" release notes.  We still need the
    migration guide.<br>
    <br>
    <div class="moz-cite-prefix">On 2/25/2016 6:05 AM, Stian Thorgersen
      wrote:<br>
    </div>
    <blockquote
cite="mid:CAJgngAeZ6Jjc06N3hvbs0O-xSxwzuOWgzDYiwRVWgWrXKiyAbg@mail.gmail.com"
      type="cite">
      <div dir="ltr">What I'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 moz-do-not-send="true"
              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 moz-do-not-send="true"
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 class="h5">
                  <div> </div>
                  <div><br>
                    <div>
                      <blockquote type="cite">
                        <div>On 25 Feb 2016, at 11:24, Marek Posolda
                          &lt;<a moz-do-not-send="true"
                            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't miss
                              it, is to put the note into release
                              announcement? Just something high level
                              like "We changed location of themes and
                              did some other changes XYZ. Don't forget
                              to read migration guide for more details"
                              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>"Before you get started" will that
                                  be read though? I can'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 moz-do-not-send="true"
                                      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'd
                                        add a section in the very
                                        beginning of our guide called
                                        "Before you get started".</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
                                              moz-do-not-send="true"
                                              href="mailto:sthorger@redhat.com"
                                              target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:sthorger@redhat.com">sthorger@redhat.com</a></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
                                                  moz-do-not-send="true"
                                                  href="http://info.nl"
                                                  target="_blank">
                                                  Info.nl</a> <span
                                                  dir="ltr">&lt;<a
                                                    moz-do-not-send="true"
href="mailto:Edgar@info.nl" target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:Edgar@info.nl">Edgar@info.nl</a></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
                                                          moz-do-not-send="true"
href="mailto:sthorger@redhat.com" target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:sthorger@redhat.com">sthorger@redhat.com</a></a>&gt;
                                                          wrote:</div>
                                                          <br>
                                                          <div>
                                                          <div dir="ltr">Yes,
                                                          it has moved.
                                                          I forgot to
                                                          update the
                                                          themes doc,
                                                          but it'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
                                                          moz-do-not-send="true"
href="http://keycloak.github.io/docs/userguide/keycloak-server/html/Migration_from_older_versions.html#d4e3997"
target="_blank"><a class="moz-txt-link-freetext" href="http://keycloak.github.io/docs/userguide/keycloak-server/html/Migration_from_older_versions.html#d4e3997">http://keycloak.github.io/docs/userguide/keycloak-server/html/Migration_from_older_versions.html#d4e3997</a></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
                                                          moz-do-not-send="true"
href="mailto:thomas.darimont@googlemail.com" target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:thomas.darimont@googlemail.com">thomas.darimont@googlemail.com</a></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
                                                          moz-do-not-send="true"
href="http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html"
target="_blank"><a class="moz-txt-link-freetext" href="http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html">http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html</a></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
moz-do-not-send="true" href="http://info.nl/" target="_blank">
                                                          Info.nl</a> <span
                                                          dir="ltr">&lt;<a
moz-do-not-send="true" href="mailto:Edgar@info.nl" target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:Edgar@info.nl">Edgar@info.nl</a></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
                                                          moz-do-not-send="true"
href="http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html#d4e2431"
target="_blank"><a class="moz-txt-link-freetext" href="http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html#d4e2431">http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html#d4e2431</a></a><br>
                                                          <br>
                                                          cheers<br>
                                                          <br>
                                                          Edgar<br>
_______________________________________________<br>
                                                          keycloak-user
                                                          mailing list<br>
                                                          <a
                                                          moz-do-not-send="true"
href="mailto:keycloak-user@lists.jboss.org" target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:keycloak-user@lists.jboss.org">keycloak-user@lists.jboss.org</a></a><br>
                                                          <a
                                                          moz-do-not-send="true"
href="https://lists.jboss.org/mailman/listinfo/keycloak-user"
                                                          target="_blank"><a class="moz-txt-link-freetext" href="https://lists.jboss.org/mailman/listinfo/keycloak-user">https://lists.jboss.org/mailman/listinfo/keycloak-user</a></a><br>
                                                          </blockquote>
                                                          </div>
                                                          <br>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          keycloak-user
                                                          mailing list<br>
                                                          <a
                                                          moz-do-not-send="true"
href="mailto:keycloak-user@lists.jboss.org" target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:keycloak-user@lists.jboss.org">keycloak-user@lists.jboss.org</a></a><br>
                                                          <a
                                                          moz-do-not-send="true"
href="https://lists.jboss.org/mailman/listinfo/keycloak-user"
                                                          rel="noreferrer"
target="_blank"><a class="moz-txt-link-freetext" href="https://lists.jboss.org/mailman/listinfo/keycloak-user">https://lists.jboss.org/mailman/listinfo/keycloak-user</a></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 moz-do-not-send="true"
                                              href="mailto:keycloak-user@lists.jboss.org"
                                              target="_blank">keycloak-user@lists.jboss.org</a><br>
                                            <a moz-do-not-send="true"
                                              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 moz-do-not-send="true" href="mailto:keycloak-user@lists.jboss.org" target="_blank">keycloak-user@lists.jboss.org</a>
<a moz-do-not-send="true" 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 class="mimeAttachmentHeader"></fieldset>
      <br>
      <pre wrap="">_______________________________________________
keycloak-user mailing list
<a class="moz-txt-link-abbreviated" href="mailto:keycloak-user@lists.jboss.org">keycloak-user@lists.jboss.org</a>
<a class="moz-txt-link-freetext" href="https://lists.jboss.org/mailman/listinfo/keycloak-user">https://lists.jboss.org/mailman/listinfo/keycloak-user</a></pre>
    </blockquote>
    <br>
    <pre class="moz-signature" cols="72">-- 
Bill Burke
JBoss, a division of Red Hat
<a class="moz-txt-link-freetext" href="http://bill.burkecentral.com">http://bill.burkecentral.com</a></pre>
  </body>
</html>