Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Petr Spacek

On 24.1.2014 18:46, Dmitri Pal wrote:

On 01/24/2014 10:39 AM, Rob Crittenden wrote:

Martin Kosek wrote:

When working on release, this question comes to my mind every time -
what is
the following page good for? :)

http://www.freeipa.org/page/Changelog

To me, it is usually just an annoyance of the release process. You
can simply
get all the data with git log derivatives, so I do not see a point of
maintaining this page.

I see benefits of having shortlog in Release pages like [1], but not
with this
one. I am thus proposing to deprecate it.

[1] http://www.freeipa.org/page/Releases/3.3.3

Thanks.



I used to just cherry-pick the big things then figured that some
people care about everything so switched to that instead. Yes, the
data is in git, but if one doesn't know git well then it can be hard
to tell where something was fixed.

I won't yell if it's dropped, but it's just a cut-n-paste after all.


It is internet search-able and can be easily pointed to in different
follow up materials.
I would rather keep it, but a wiki formatting script might be a good idea.


Our git repo has nice and responsive web interface:
https://git.fedorahosted.org/cgit/freeipa.git/

The advantage is that you can read full commit messages so you can see links 
to tickets in Trac which are not present in shortlog.


Given that I think that Changelog wiki page is mostly annoyance, it could 
simply redirect to repo web interface (may be to listings for specific branches).


--
Petr^2 Spacek

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Martin Kosek
On 01/27/2014 09:08 AM, Petr Spacek wrote:
 On 24.1.2014 18:46, Dmitri Pal wrote:
 On 01/24/2014 10:39 AM, Rob Crittenden wrote:
 Martin Kosek wrote:
 When working on release, this question comes to my mind every time -
 what is
 the following page good for? :)

 http://www.freeipa.org/page/Changelog

 To me, it is usually just an annoyance of the release process. You
 can simply
 get all the data with git log derivatives, so I do not see a point of
 maintaining this page.

 I see benefits of having shortlog in Release pages like [1], but not
 with this
 one. I am thus proposing to deprecate it.

 [1] http://www.freeipa.org/page/Releases/3.3.3

 Thanks.


 I used to just cherry-pick the big things then figured that some
 people care about everything so switched to that instead. Yes, the
 data is in git, but if one doesn't know git well then it can be hard
 to tell where something was fixed.

 I won't yell if it's dropped, but it's just a cut-n-paste after all.

 It is internet search-able and can be easily pointed to in different
 follow up materials.
 I would rather keep it, but a wiki formatting script might be a good idea.
 
 Our git repo has nice and responsive web interface:
 https://git.fedorahosted.org/cgit/freeipa.git/
 
 The advantage is that you can read full commit messages so you can see links 
 to
 tickets in Trac which are not present in shortlog.
 
 Given that I think that Changelog wiki page is mostly annoyance, it could
 simply redirect to repo web interface (may be to listings for specific 
 branches).

Right, that was my thinking as well. The Changelog just duplicates information
that is already internet-searchable in:
* cgit
* Mails and patches on freeipa-devel mailing list archive
* Release specific Changelog excerpt in Release page

Thus, I still do not see a reason in maintaining the huge Changelog page.

Martin

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Martin Kosek
On 01/27/2014 04:02 PM, Petr Viktorin wrote:
 On 01/27/2014 03:32 PM, Rob Crittenden wrote:
 [...]
 It is useful because you can more easily see what made it into the
 particular dot release rather than finding the patch you want then
 knowing to search backwards for the Become xx.yy commit. I saw it as a
 poor-man's way of finding changes.
 
 I think a poor man can open up the individual Release notes and look there.
 
 
 And a rich man (who has the repo cloned) can just use Git.
 
 $ git log -i --grep 'drop selinux'
 commit ad6abdb576b2ebeb941eb99fd141bf78918143c1
 Author: Martin Kosek mko...@redhat.com
 Date:   Thu Jun 13 14:40:52 2013 +0200
 
 Drop SELinux subpackage
 
 All SELinux policy needed by FreeIPA server is now part of the global
 system SELinux policy which makes the subpackage redundant and slowing
 down the installation. This patch drops it.
 
 https://fedorahosted.org/freeipa/ticket/3683
 https://fedorahosted.org/freeipa/ticket/3684
 
 $ git tag --contains ad6abdb576b2ebeb941eb99fd141bf78918143c1
 beta_1-3-3-0
 beta_2-3-3-0
 release-3-3-0
 release-3-3-1
 release-3-3-2
 release-3-3-3

I couldn't say it better. Let's drop the manual changelog and use some modern
way to do it - case is closed.

Martin

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Rob Crittenden

Petr Spacek wrote:

On 24.1.2014 18:46, Dmitri Pal wrote:

On 01/24/2014 10:39 AM, Rob Crittenden wrote:

Martin Kosek wrote:

When working on release, this question comes to my mind every time -
what is
the following page good for? :)

http://www.freeipa.org/page/Changelog

To me, it is usually just an annoyance of the release process. You
can simply
get all the data with git log derivatives, so I do not see a point of
maintaining this page.

I see benefits of having shortlog in Release pages like [1], but not
with this
one. I am thus proposing to deprecate it.

[1] http://www.freeipa.org/page/Releases/3.3.3

Thanks.



I used to just cherry-pick the big things then figured that some
people care about everything so switched to that instead. Yes, the
data is in git, but if one doesn't know git well then it can be hard
to tell where something was fixed.

I won't yell if it's dropped, but it's just a cut-n-paste after all.


It is internet search-able and can be easily pointed to in different
follow up materials.
I would rather keep it, but a wiki formatting script might be a good
idea.


Our git repo has nice and responsive web interface:
https://git.fedorahosted.org/cgit/freeipa.git/

The advantage is that you can read full commit messages so you can see
links to tickets in Trac which are not present in shortlog.

Given that I think that Changelog wiki page is mostly annoyance, it
could simply redirect to repo web interface (may be to listings for
specific branches).



It is useful because you can more easily see what made it into the 
particular dot release rather than finding the patch you want then 
knowing to search backwards for the Become xx.yy commit. I saw it as a 
poor-man's way of finding changes.


It gets updated 3 or 4 times a year, so it is hardly a burden.

It is certainly duplicated information and I won't fight any further for it.

rob

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Martin Kosek
On 01/27/2014 03:32 PM, Rob Crittenden wrote:
 Petr Spacek wrote:
 On 24.1.2014 18:46, Dmitri Pal wrote:
 On 01/24/2014 10:39 AM, Rob Crittenden wrote:
 Martin Kosek wrote:
 When working on release, this question comes to my mind every time -
 what is
 the following page good for? :)

 http://www.freeipa.org/page/Changelog

 To me, it is usually just an annoyance of the release process. You
 can simply
 get all the data with git log derivatives, so I do not see a point of
 maintaining this page.

 I see benefits of having shortlog in Release pages like [1], but not
 with this
 one. I am thus proposing to deprecate it.

 [1] http://www.freeipa.org/page/Releases/3.3.3

 Thanks.


 I used to just cherry-pick the big things then figured that some
 people care about everything so switched to that instead. Yes, the
 data is in git, but if one doesn't know git well then it can be hard
 to tell where something was fixed.

 I won't yell if it's dropped, but it's just a cut-n-paste after all.

 It is internet search-able and can be easily pointed to in different
 follow up materials.
 I would rather keep it, but a wiki formatting script might be a good
 idea.

 Our git repo has nice and responsive web interface:
 https://git.fedorahosted.org/cgit/freeipa.git/

 The advantage is that you can read full commit messages so you can see
 links to tickets in Trac which are not present in shortlog.

 Given that I think that Changelog wiki page is mostly annoyance, it
 could simply redirect to repo web interface (may be to listings for
 specific branches).

 
 It is useful because you can more easily see what made it into the particular
 dot release rather than finding the patch you want then knowing to search
 backwards for the Become xx.yy commit. I saw it as a poor-man's way of finding
 changes.

Ok, though I still think that git and cgit should be the authoritative source
of searches like this...

 It gets updated 3 or 4 times a year, so it is hardly a burden.

3-4 times? I see 19 updates happening in 2013 in this page. With each release
(even a minor one) we do, we need to do prepare shortlog, apply wiki and the
specific date format and paste it here.

 
 It is certainly duplicated information and I won't fight any further for it.
 
 rob

Noted :)

Martin

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Petr Viktorin

On 01/27/2014 03:32 PM, Rob Crittenden wrote:
[...]

It is useful because you can more easily see what made it into the
particular dot release rather than finding the patch you want then
knowing to search backwards for the Become xx.yy commit. I saw it as a
poor-man's way of finding changes.


I think a poor man can open up the individual Release notes and look 
there.



And a rich man (who has the repo cloned) can just use Git.

$ git log -i --grep 'drop selinux'
commit ad6abdb576b2ebeb941eb99fd141bf78918143c1
Author: Martin Kosek mko...@redhat.com
Date:   Thu Jun 13 14:40:52 2013 +0200

Drop SELinux subpackage

All SELinux policy needed by FreeIPA server is now part of the global
system SELinux policy which makes the subpackage redundant and slowing
down the installation. This patch drops it.

https://fedorahosted.org/freeipa/ticket/3683
https://fedorahosted.org/freeipa/ticket/3684

$ git tag --contains ad6abdb576b2ebeb941eb99fd141bf78918143c1
beta_1-3-3-0
beta_2-3-3-0
release-3-3-0
release-3-3-1
release-3-3-2
release-3-3-3


--
PetrĀ³

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Martin Kosek
On 01/27/2014 05:23 PM, Simo Sorce wrote:
 On Mon, 2014-01-27 at 16:53 +0100, Martin Kosek wrote:
 On 01/27/2014 04:02 PM, Petr Viktorin wrote:
 On 01/27/2014 03:32 PM, Rob Crittenden wrote:
 [...]
 It is useful because you can more easily see what made it into the
 particular dot release rather than finding the patch you want then
 knowing to search backwards for the Become xx.yy commit. I saw it as a
 poor-man's way of finding changes.

 I think a poor man can open up the individual Release notes and look 
 there.


 And a rich man (who has the repo cloned) can just use Git.

 $ git log -i --grep 'drop selinux'
 commit ad6abdb576b2ebeb941eb99fd141bf78918143c1
 Author: Martin Kosek mko...@redhat.com
 Date:   Thu Jun 13 14:40:52 2013 +0200

 Drop SELinux subpackage

 All SELinux policy needed by FreeIPA server is now part of the global
 system SELinux policy which makes the subpackage redundant and slowing
 down the installation. This patch drops it.

 https://fedorahosted.org/freeipa/ticket/3683
 https://fedorahosted.org/freeipa/ticket/3684

 $ git tag --contains ad6abdb576b2ebeb941eb99fd141bf78918143c1
 beta_1-3-3-0
 beta_2-3-3-0
 release-3-3-0
 release-3-3-1
 release-3-3-2
 release-3-3-3

 I couldn't say it better. Let's drop the manual changelog and use some modern
 way to do it - case is closed.
 
 May be you can stick into the Release notes page the actual query that
 gives you the changelog from cgit ?
 
 It should probably be
 https://git.fedorahosted.org/cgit/freeipa.git/log/?qt=rangeq=release-3.3.2..release-3.3.3
 
 But at the moment it returns an internal server error, I will ask on
 fedora-admin
 
 Simo.

I can do that. Just note that the between-versions diff changelog in Release
notes stays, we are just discussing removing the global one [1].

Martin

[1] http://www.freeipa.org/page/Changelog

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-27 Thread Simo Sorce
On Mon, 2014-01-27 at 16:53 +0100, Martin Kosek wrote:
 On 01/27/2014 04:02 PM, Petr Viktorin wrote:
  On 01/27/2014 03:32 PM, Rob Crittenden wrote:
  [...]
  It is useful because you can more easily see what made it into the
  particular dot release rather than finding the patch you want then
  knowing to search backwards for the Become xx.yy commit. I saw it as a
  poor-man's way of finding changes.
  
  I think a poor man can open up the individual Release notes and look 
  there.
  
  
  And a rich man (who has the repo cloned) can just use Git.
  
  $ git log -i --grep 'drop selinux'
  commit ad6abdb576b2ebeb941eb99fd141bf78918143c1
  Author: Martin Kosek mko...@redhat.com
  Date:   Thu Jun 13 14:40:52 2013 +0200
  
  Drop SELinux subpackage
  
  All SELinux policy needed by FreeIPA server is now part of the global
  system SELinux policy which makes the subpackage redundant and slowing
  down the installation. This patch drops it.
  
  https://fedorahosted.org/freeipa/ticket/3683
  https://fedorahosted.org/freeipa/ticket/3684
  
  $ git tag --contains ad6abdb576b2ebeb941eb99fd141bf78918143c1
  beta_1-3-3-0
  beta_2-3-3-0
  release-3-3-0
  release-3-3-1
  release-3-3-2
  release-3-3-3
 
 I couldn't say it better. Let's drop the manual changelog and use some modern
 way to do it - case is closed.

May be you can stick into the Release notes page the actual query that
gives you the changelog from cgit ?

It should probably be
https://git.fedorahosted.org/cgit/freeipa.git/log/?qt=rangeq=release-3.3.2..release-3.3.3

But at the moment it returns an internal server error, I will ask on
fedora-admin

Simo.

-- 
Simo Sorce * Red Hat, Inc * New York

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


[Freeipa-devel] What is Changelog on wiki for?

2014-01-24 Thread Martin Kosek
When working on release, this question comes to my mind every time - what is
the following page good for? :)

http://www.freeipa.org/page/Changelog

To me, it is usually just an annoyance of the release process. You can simply
get all the data with git log derivatives, so I do not see a point of
maintaining this page.

I see benefits of having shortlog in Release pages like [1], but not with this
one. I am thus proposing to deprecate it.

[1] http://www.freeipa.org/page/Releases/3.3.3

Thanks.

-- 
Martin Kosek mko...@redhat.com
Supervisor, Software Engineering - Identity Management Team
Red Hat Inc.

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-24 Thread Rob Crittenden

Martin Kosek wrote:

When working on release, this question comes to my mind every time - what is
the following page good for? :)

http://www.freeipa.org/page/Changelog

To me, it is usually just an annoyance of the release process. You can simply
get all the data with git log derivatives, so I do not see a point of
maintaining this page.

I see benefits of having shortlog in Release pages like [1], but not with this
one. I am thus proposing to deprecate it.

[1] http://www.freeipa.org/page/Releases/3.3.3

Thanks.



I used to just cherry-pick the big things then figured that some people 
care about everything so switched to that instead. Yes, the data is in 
git, but if one doesn't know git well then it can be hard to tell where 
something was fixed.


I won't yell if it's dropped, but it's just a cut-n-paste after all.

rob

___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel


Re: [Freeipa-devel] What is Changelog on wiki for?

2014-01-24 Thread Dmitri Pal
On 01/24/2014 10:39 AM, Rob Crittenden wrote:
 Martin Kosek wrote:
 When working on release, this question comes to my mind every time -
 what is
 the following page good for? :)

 http://www.freeipa.org/page/Changelog

 To me, it is usually just an annoyance of the release process. You
 can simply
 get all the data with git log derivatives, so I do not see a point of
 maintaining this page.

 I see benefits of having shortlog in Release pages like [1], but not
 with this
 one. I am thus proposing to deprecate it.

 [1] http://www.freeipa.org/page/Releases/3.3.3

 Thanks.


 I used to just cherry-pick the big things then figured that some
 people care about everything so switched to that instead. Yes, the
 data is in git, but if one doesn't know git well then it can be hard
 to tell where something was fixed.

 I won't yell if it's dropped, but it's just a cut-n-paste after all.

It is internet search-able and can be easily pointed to in different
follow up materials.
I would rather keep it, but a wiki formatting script might be a good idea.


 rob

 ___
 Freeipa-devel mailing list
 Freeipa-devel@redhat.com
 https://www.redhat.com/mailman/listinfo/freeipa-devel


-- 
Thank you,
Dmitri Pal

Sr. Engineering Manager for IdM portfolio
Red Hat Inc.


---
Looking to carve out IT costs?
www.redhat.com/carveoutcosts/



___
Freeipa-devel mailing list
Freeipa-devel@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-devel