Jira already generates "proper" release notes. We still need the
migration guide.
On 2/25/2016 6:05 AM, Stian Thorgersen wrote:
What I'm going to do is:
* Short term - start mentioning important migration issues in release
announcement and link to migration doc
* Long term - start creating proper release notes and include in
documentation, release announcement in the future will just be
highlights and link to this
Comments?
On 25 February 2016 at 11:36, Edgar Vonk - Info.nl <Edgar(a)info.nl
<mailto:Edgar@info.nl>> wrote:
that would certainly help indeed!
as an example this is how Magnolia (a Java CMS we often use in our
projects) does it:
https://forums.magnolia-cms.com/forum/thread.html?threadId=5f23d559-16be-...
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.
> On 25 Feb 2016, at 11:24, Marek Posolda <mposolda(a)redhat.com
> <mailto:mposolda@redhat.com>> wrote:
>
> 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?
>
> Marek
>
> On 25/02/16 10:28, Stian Thorgersen wrote:
>> Bruno: No need to update theme chapter - Marc from APIMan is
>> already on the task :)
>>
>> "Before you get started" will that be read though? I can't see
>> current users reading that.
>>
>> On 25 February 2016 at 10:25, Bruno Oliveira
>> <bruno(a)abstractj.org <mailto:bruno@abstractj.org>> wrote:
>>
>> I will review the whole theme chapter today and see if I
>> find any mismatches.
>>
>> Regarding your question, I'd add a section in the very
>> beginning of our guide called "Before you get started".
>>
>> On Thu, Feb 25, 2016 at 6:23 AM Stian Thorgersen
>> <sthorger(a)redhat.com <mailto:sthorger@redhat.com>> wrote:
>>
>> Any tips on how we can make it more obvious to users to
>> read the migration guide?
>>
>> On 25 February 2016 at 10:21, Edgar Vonk - Info.nl
>> <
http://info.nl> <Edgar(a)info.nl
<mailto:Edgar@info.nl>>
>> wrote:
>>
>> ok, thanks! you are right, I should have read the
>> migration guide.
>>
>>> On 25 Feb 2016, at 10:19, Stian Thorgersen
>>> <sthorger(a)redhat.com
<mailto:sthorger@redhat.com>>
>>> wrote:
>>>
>>> Yes, it has moved. I forgot to update the themes
>>> doc, but it's included in the migration guide.
>>>
>>> Always read the migration guide before upgrading!
>>> It will quite likely save you a lot of time.
>>>
http://keycloak.github.io/docs/userguide/keycloak-server/html/Migration_f...
>>>
>>> On 25 February 2016 at 10:00, Thomas Darimont
>>> <thomas.darimont(a)googlemail.com
>>> <mailto:thomas.darimont@googlemail.com>> wrote:
>>>
>>> This was discussed a few days ago on the dev list:
>>>
http://lists.jboss.org/pipermail/keycloak-dev/2016-February/006638.html
>>>
>>> Perhaphs there should have sent a mail to the
>>> user-list as well...
>>>
>>> Cheers,
>>> Thomas
>>>
>>> 2016-02-25 9:31 GMT+01:00 Edgar Vonk - Info.nl
>>> <
http://info.nl/> <Edgar(a)info.nl
>>> <mailto:Edgar@info.nl>>:
>>>
>>> Hi,
>>>
>>> It seems that the themes folder has moved
>>> in Keycloak 1.9.0.Final (from 1.9.0.RC1)?
>>>
>>> The themes folder used to be:
>>> $KEYCLOAK_HOME/standalone/configuration/themes
>>>
>>> but now it seems to be:
>>> $KEYCLOAK_HOME/themes
>>>
>>> The documentation still mentions the old
>>> location so I think needs to be updated?
>>>
http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html...
>>>
>>> cheers
>>>
>>> Edgar
>>> _______________________________________________
>>> keycloak-user mailing list
>>> keycloak-user(a)lists.jboss.org
>>> <mailto:keycloak-user@lists.jboss.org>
>>>
https://lists.jboss.org/mailman/listinfo/keycloak-user
>>>
>>>
>>>
>>> _______________________________________________
>>> keycloak-user mailing list
>>> keycloak-user(a)lists.jboss.org
>>> <mailto:keycloak-user@lists.jboss.org>
>>>
https://lists.jboss.org/mailman/listinfo/keycloak-user
>>>
>>>
>>
>>
>> _______________________________________________
>> keycloak-user mailing list
>> keycloak-user(a)lists.jboss.org
>> <mailto:keycloak-user@lists.jboss.org>
>>
https://lists.jboss.org/mailman/listinfo/keycloak-user
>>
>>
>>
>>
>> _______________________________________________
>> keycloak-user mailing list
>> keycloak-user(a)lists.jboss.org <mailto:keycloak-user@lists.jboss.org>
>>
https://lists.jboss.org/mailman/listinfo/keycloak-user
>
_______________________________________________
keycloak-user mailing list
keycloak-user(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/keycloak-user