Re: [Geany-devel] plugins.geany.org now updating automatically via cronjob

2011-02-12 Thread Enrico Tröger
On Sat, 12 Feb 2011 03:05:44 +0100, Frank wrote:

On Sat, 12 Feb 2011 00:04:32 +0100
Dominic Hopf dma...@googlemail.com wrote:

 Am Freitag, den 11.02.2011, 23:56 +0100 schrieb Dominic Hopf:
  In detail, this means the descriptions for your plugins at
  plugins.geany.org, which are generated from your README files, will
  be updated once per day at 04:05 UTC.
 
 Maybe it would be also a good idea to increase the frequency to every
 hour or so? Tell me what you think.

Not sure whether every hour is really necessary. It's just that it
probably takes some server resources...but to be honest I didn't know
what the script does so I can't judge on that at this point.

But as you said in your first mail, plugin authors should keep the
information in the READMEs consistent with the released version.
This doesn't make much sense to me. The README in SVN should reflect
the latest development changes.
But I agree to have a version online at the website which fits the
released version. So, IMO it's better to adjust your script to generate
HTML from the tagged READMEs. And this is just necessary after a
release, not every hour.
What do you think?


Regards,
Enrico

-- 
Get my GPG key from http://www.uvena.de/pub.asc


pgpTDtKLibTs3.pgp
Description: PGP signature
___
Geany-devel mailing list
Geany-devel@uvena.de
http://lists.uvena.de/cgi-bin/mailman/listinfo/geany-devel


Re: [Geany-devel] plugins.geany.org now updating automatically via cronjob

2011-02-12 Thread Dominic Hopf
Am Samstag, den 12.02.2011, 12:24 +0100 schrieb Enrico Tröger:
 On Sat, 12 Feb 2011 03:05:44 +0100, Frank wrote:
 
 On Sat, 12 Feb 2011 00:04:32 +0100
 Dominic Hopf dma...@googlemail.com wrote:
 
  Am Freitag, den 11.02.2011, 23:56 +0100 schrieb Dominic Hopf:
   In detail, this means the descriptions for your plugins at
   plugins.geany.org, which are generated from your README files, will
   be updated once per day at 04:05 UTC.
  
  Maybe it would be also a good idea to increase the frequency to every
  hour or so? Tell me what you think.
 
 Not sure whether every hour is really necessary. It's just that it
 probably takes some server resources...but to be honest I didn't know
 what the script does so I can't judge on that at this point.
 
 But as you said in your first mail, plugin authors should keep the
 information in the READMEs consistent with the released version.
 This doesn't make much sense to me. The README in SVN should reflect
 the latest development changes.
 But I agree to have a version online at the website which fits the
 released version. So, IMO it's better to adjust your script to generate
 HTML from the tagged READMEs. And this is just necessary after a
 release, not every hour.
 What do you think?

I wouldn't generate the website from tagged releases, since they
shouldn't be changed after the release from my point of view. Plugin
developers may want to improve other things on their README files, in
special when seeing something isn't displayed that optimal on the
website, I think it is a more good idea to generate the website from
trunk. But this would imply, the informations contained in the README
files are consistent with the released tarballs.

Otherwise, if we generate the website from tagged releases, this would
mean something would be fucked up until the next release, in the worst
case.

few other thoughts to this topic:

* have an additional README.stable
* and maybe generate an additional plugins.geany.org/svn/

Regards,
Dominic

-- 
Dominic Hopf dma...@googlemail.com
http://dominichopf.de/

Key Fingerprint: A7DF C4FC 07AE 4DDC 5CA0 BD93 AAB0 6019 CA7D 868D


signature.asc
Description: This is a digitally signed message part
___
Geany-devel mailing list
Geany-devel@uvena.de
http://lists.uvena.de/cgi-bin/mailman/listinfo/geany-devel


Re: [Geany-devel] plugins.geany.org now updating automatically via cronjob

2011-02-12 Thread Enrico Tröger
On Sat, 12 Feb 2011 13:59:27 +0100, Dominic wrote:

Am Samstag, den 12.02.2011, 12:24 +0100 schrieb Enrico Tröger:
 On Sat, 12 Feb 2011 03:05:44 +0100, Frank wrote:
 
 On Sat, 12 Feb 2011 00:04:32 +0100
 Dominic Hopf dma...@googlemail.com wrote:
 
  Am Freitag, den 11.02.2011, 23:56 +0100 schrieb Dominic Hopf:
   In detail, this means the descriptions for your plugins at
   plugins.geany.org, which are generated from your README files,
   will be updated once per day at 04:05 UTC.
  
  Maybe it would be also a good idea to increase the frequency to
  every hour or so? Tell me what you think.
 
 Not sure whether every hour is really necessary. It's just that it
 probably takes some server resources...but to be honest I didn't know
 what the script does so I can't judge on that at this point.
 
 But as you said in your first mail, plugin authors should keep the
 information in the READMEs consistent with the released version.
 This doesn't make much sense to me. The README in SVN should reflect
 the latest development changes.
 But I agree to have a version online at the website which fits the
 released version. So, IMO it's better to adjust your script to
 generate HTML from the tagged READMEs. And this is just necessary
 after a release, not every hour.
 What do you think?

I wouldn't generate the website from tagged releases, since they
shouldn't be changed after the release from my point of view. Plugin
developers may want to improve other things on their README files, in
special when seeing something isn't displayed that optimal on the
website, I think it is a more good idea to generate the website from
trunk. But this would imply, the informations contained in the README
files are consistent with the released tarballs.

Otherwise, if we generate the website from tagged releases, this would
mean something would be fucked up until the next release, in the worst
case.

True.
My suggestion was based on your statement, the README content should
match the released plugin version.
Maybe this isn't necessary at all. I don't see READMEs as
the documentation of a plugin and so the README should be as up to date
as necessary and should not match a months old release state.
Just my 2cents.


few other thoughts to this topic:

* have an additional README.stable

I think this would generate just many redundant information without
real benefit. Additional, it could confuse users who are unsure which
README to read.

* and maybe generate an additional plugins.geany.org/svn/

Similar as above.


Regards,
Enrico

-- 
Get my GPG key from http://www.uvena.de/pub.asc


pgpCKsqCNEh3n.pgp
Description: PGP signature
___
Geany-devel mailing list
Geany-devel@uvena.de
http://lists.uvena.de/cgi-bin/mailman/listinfo/geany-devel


Re: [Geany-devel] plugins.geany.org now updating automatically via cronjob

2011-02-12 Thread Dominic Hopf
Am Samstag, den 12.02.2011, 14:19 +0100 schrieb Enrico Tröger:
 True.
 My suggestion was based on your statement, the README content should
 match the released plugin version.
To avoid confusion: I was talking about the informations contained in
the README file, not the content. I don't want any plugin developer to
fit his README file 1:1 with the released file. I just was suggesting to
be consistent with the behavior the actual released plugin behaves. And
this is just a suggestion, no requirement. It's still up to the plugin
developer how he maintains his README. :)

 Maybe this isn't necessary at all. I don't see READMEs as
 the documentation of a plugin and so the README should be as up to date
 as necessary and should not match a months old release state.
 Just my 2cents.
Of course. Consistency with the described behavior and the
up-to-dateness don't exclude each other. :)

Regards,
Dominic

-- 
Dominic Hopf dma...@googlemail.com
http://dominichopf.de/

Key Fingerprint: A7DF C4FC 07AE 4DDC 5CA0 BD93 AAB0 6019 CA7D 868D


signature.asc
Description: This is a digitally signed message part
___
Geany-devel mailing list
Geany-devel@uvena.de
http://lists.uvena.de/cgi-bin/mailman/listinfo/geany-devel


Re: [Geany-devel] plugins.geany.org now updating automatically via cronjob

2011-02-11 Thread Dominic Hopf
Am Freitag, den 11.02.2011, 23:56 +0100 schrieb Dominic Hopf:
 In detail, this means the descriptions for your plugins at
 plugins.geany.org, which are generated from your README files, will be
 updated once per day at 04:05 UTC.

Maybe it would be also a good idea to increase the frequency to every
hour or so? Tell me what you think.

Regards,
Dominic

-- 
Dominic Hopf dma...@googlemail.com
http://dominichopf.de/

Key Fingerprint: A7DF C4FC 07AE 4DDC 5CA0 BD93 AAB0 6019 CA7D 868D


signature.asc
Description: This is a digitally signed message part
___
Geany-devel mailing list
Geany-devel@uvena.de
http://lists.uvena.de/cgi-bin/mailman/listinfo/geany-devel


Re: [Geany-devel] plugins.geany.org now updating automatically via cronjob

2011-02-11 Thread Frank Lanitz
On Sat, 12 Feb 2011 00:04:32 +0100
Dominic Hopf dma...@googlemail.com wrote:

 Am Freitag, den 11.02.2011, 23:56 +0100 schrieb Dominic Hopf:
  In detail, this means the descriptions for your plugins at
  plugins.geany.org, which are generated from your README files, will
  be updated once per day at 04:05 UTC.
 
 Maybe it would be also a good idea to increase the frequency to every
 hour or so? Tell me what you think.

I'm thinking about a post-commit hook which is deploying it after
tagging (or something like this)

Cheers, 
Frank
-- 
http://frank.uvena.de/en/


pgpDEw3IMvVNZ.pgp
Description: PGP signature
___
Geany-devel mailing list
Geany-devel@uvena.de
http://lists.uvena.de/cgi-bin/mailman/listinfo/geany-devel