... or perhaps a .htaccess file containing AddDescription lines, stating as briefly as possible what these things do, so that I don't have to download and unzip every one of them to find out?Thanks.
I agree we need to split the -extras. How about trunk and tags (with
standardised naming of tags), with the latest tag being put
automatically onto /dist as all -extras commits are now?
I also think Sean's earlier suggestion of owners or maintainers for
everything in -extras is something we should do.
--
Michael C. Harris, School of CS&IT, RMIT University
http://twofishcreative.com/michael/blog
The reason I suggested tags was that at some point we will support
more than one release.
> Splitting /extras at the root would be a PITA to maintain.
I wasn't suggesting that, sorry if I wasn't clear.
> What I'm wondering is who's going to be the maintainer of each
> plugin's stable.
I'm not sure what you mean. I'm happy to be the maintainer of all the
plugins I've committed. If other people put their hand up and say
they're happy to maintain theirs, that's fine. If there are some that
don't have a maintainer, we can discuss what happens to them then.
> As much as I'm for liberty, there should be strict guidelines (like
> Habari's trunk) and appointed people to build the zips.
What sort of guidelines were you thinking of?
> miklb was talking about having zips built on the fly, don't know SVN
> enough to figure that out.
We do that now, afaik. That's what's in /dist.
What I was suggesting is let's set up a system if there are any
plugins that don't have a maintainer we can deal with it then. One
step at a time.
> > > As much as I'm for liberty, there should be strict guidelines (like
> > > Habari's trunk) and appointed people to build the zips.
> >
> > What sort of guidelines were you thinking of?
>
> Compression, no DSTORE (or whatever is the Mac OS X hidden file)
> no .ThumbsDB :P
> Do we put the files in a folder, or not, etc..
All dealt with in be subversion hook script.
> > > miklb was talking about having zips built on the fly, don't know SVN
> > > enough to figure that out.
> >
> > We do that now, afaik. That's what's in /dist.
>
> How do does get created?
I haven't read his email yet, but I think Owen answers the question.
Splitting the whole -extras repo sounds like the way to go. The second
part of your idea sounds like plugin content types, which I've been
mulling over for a while as a way to show off plugins. An additional
feature of the plugin content type might be to allow users to "Add
this plugin to my download bundle" so that users can browse the plugin
posts on hp.o and download a bunch of them at once to be unzipped in
user/plugins.
> Potential additional features could be to add new repo directories
> from the server, and to provide a non-svn interface for interacting
> with svn. For example, we could allow theme builders to upload a zip
> file of their theme, which would be extracted into a working copy of
> their theme from svn, then committed from the server itself. This
> might help get around some themers' reluctance to using the repo.
... and a theme content type for showing off themes, which could have
a theme switcher built in. Theme authors could use it on their own
sites for themes they don't want to submit to -extras and it could be
used on hp.o for the themes in -extras.
+1
Those in favour of naming a maintainer for everything in the -extras
repo (details can be argued about) say +1:
+1
V
In that case, probably I'm +1 as well....
V
Yes, that's the vote I was proposing, that one person be "responsible"
for each project. That doesn't necessarily mean that they'd do all the
coding necessary or anything like that, but they'd be the person to
contact and keep an eye on any issues.
> -----Original Message-----
> From: habar...@googlegroups.com [mailto:habar...@googlegroups.com]
> On Behalf Of Michael C. Harris
> Sent: 25. april 2008 10:55
> To: habar...@googlegroups.com
> Subject: [habari-dev] Re: Plugins directory
>
>
Those in favour of splitting the -extras repo into stable and
unstable (exact format can be argued about) say +1:
+1
Those in favour of naming a maintainer for everything in the -extras
repo (details can be argued about) say +1:
+1
What if the original creator joins a monastery and takes a vow of no
internet?
Michael C. Harris wrote:
> On Sat, Apr 26, 2008 at 07:47:23PM -0700, Andrew da Silva wrote:
>> Original Creator.
>>
>> This way we know who to ask for how the plugin behaves/works, without
>> having to ask him for permission, he's just a reference.
>
> What if the original creator joins a monastery and takes a vow of no
> internet?
>
If we maintain our rule that items in -extras belong to the community, I
don't think we need to list the original creator. As far as how it
works, we should require documentation to move from the "testing" to
"stable" branches (to steal some nomenclature from Debian).
Here is what I see as a general outline for the flow of plugins/themes
on extras.
1) New developer says "Hey I've got a plugin I'd like to contribute to
extras."
2) An extras "moderator" looks at the code to determine that it is A)
functional and B) not harmful.
3) the "moderator" then makes sure that the submitter is clear on what
the rules for -extras are (credited to the community, no ownership...),
and then sets up access to the "testing" branch for the submitter.
4) The submitter (and anyone else so inclined) can then work in the
branch. When a stable version of the Plugin/Theme is ready for release a
RC zip is made and an -extras moderator reviews it for
stability/functionality/security. Assuming it passes, an entry is
created in the "stable" branch.
Obviously, this will require some fine tuning to work properly, and
there are likely errors I'm not seeing, but I think having "moderators"
may help prevent the "ownership" issues, and like other elements of the
community, they can self-select both on the level of being moderators
(the moderators don't even have to have administrative rights to
- -extras, they can simply pass the information on to someone who does.)
as well as for the themes/plugins that they feel comfortable moderating.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iD8DBQFIFALLmQpMBUWJpdsRArMwAJ9CZrJWF0OGTX9MKzOs8ecEX7C5zgCdGcF5
vC7aS6xt17aCEtux7Jx6dgw=
=xoJB
-----END PGP SIGNATURE-----
You're right, "maintainer" has connotations that I'm not comfortable
with either. How about "shepherd"?
Some of the problems I see that we're trying to address:
- when someone raises an issue with an -extras plugin, someone should
say "Great, thanks for raising that, we'll look into it." At the
moment, there's often silence. See anything to do with pingback or
wp-importer.
- a plugin that needs work remains stagnant. The wp-importer is a
classic one here, because it is nobody's itch, but it is important.
- releasing plugins from the (soon to be) testing branch to the stable
branch.
- ensuring that the plugin is tested during release feature freezes.
We could be very clear about the fact that this is _not_ someone who
is responsible for "protecting" the code, and the code in no way
belongs to them.
Original Creator.This way we know who to ask for how the plugin behaves/works, withouthaving to ask him for permission, he's just a reference.
What if the original creator joins a monastery and takes a vow of no
internet?
Explicitly naming a maintainer for a piece of code has a number ofnegative social impacts, all of which are variations on the same thing- this code belongs to Bob, and so I'm reluctant to touch it. Eitherthe code belongs to the community, or it doesn't. If it doesn't, itdoesn't belong in our repo.
I originally felt the same way, but after I thought about the term
"maintainer", and not owner, or author, or some other term that
implied "ownership", I felt more comfortable that it simply indicated
someone taking responsibility for making sure stable releases were
maintained. What if we called them something else? Guardian ;-)
If we weren't to go this route (not having a maintainer), what would
you suggest as a solution for making sure that we were providing users
with a stable, functional plugin that was compatible with the latest
stable release? Or does your +0 vote indicate that you don't feel
that is important at this juncture of the project?
While I'm thrilled at the influx of community development on plugins
and themes, and community attribution for that matter, I have joined
in bringing this up simply because I am afraid of the effect it might
have on a new user. Currently, they can download one of these plugins
at a particular moment that it's buggy (like the other morning when I
made several poor commits), try out the plugin/theme, be turned off,
and move on. Even though we are still "alpha"/ "developer release"
officially,, I think we are really moving towards portraying the
project as as semi-stable for people to check out, which means many
people downloading zipped files, and not doing SVN, IRC, etc. I don't
want to scare them away completely.
I'd also hate to see plugins "die on the vine" because there is no one
tending to it. These people do not have to be "coders", simply
community members who want to volunteer in some fashion.
Finally, there's already a bit of confusion/fear about who's plugin is
who's, regardless of the attribution, and stepping one's toes.
Perhaps this is a good time for someone (is that the sound of me
volunteering?) blogging about what the extras repo is, how it's
intended, and where we see it going.
Explicitly naming a maintainer for a piece of code has a number ofnegative social impacts, all of which are variations on the same thing- this code belongs to Bob, and so I'm reluctant to touch it. Eitherthe code belongs to the community, or it doesn't. If it doesn't, itdoesn't belong in our repo.
You're right, "maintainer" has connotations that I'm not comfortable
with either. How about "shepherd"?
Some of the problems I see that we're trying to address:
- when someone raises an issue with an -extras plugin, someone should
say "Great, thanks for raising that, we'll look into it." At the
moment, there's often silence. See anything to do with pingback or
wp-importer.
- a plugin that needs work remains stagnant. The wp-importer is a
classic one here, because it is nobody's itch, but it is important.
- releasing plugins from the (soon to be) testing branch to the stable
branch.
- ensuring that the plugin is tested during release feature freezes.
We could be very clear about the fact that this is _not_ someone who
is responsible for "protecting" the code, and the code in no way
belongs to them.
Good point.
> > Some of the problems I see that we're trying to address: -
> > when someone raises an issue with an -extras plugin, someone
> > should say "Great, thanks for raising that, we'll look into
> > it." At the moment, there's often silence. See anything to do
> > with pingback or wp-importer.
>
> At which point, that person has the opening to step forward and grasp
> the reins and go with it. It's Open Source - you can't compel someone
> to work on this, even if their name is on a list somewhere.
The list is completely voluntary. If they don't want to be the person
who it is understood will shepherd the plugin, they can remove their
name.
> > - a plugin that needs work remains stagnant. The wp-importer is a
> > classic one here, because it is nobody's itch, but it is important.
>
> Help me understand how this would work. So, my name is listed on the
> wp-importer, but it's not my itch, because I'm all done migrating off
> of WP. How does having my name on the list make me more likely to work
> on it?
Like I said, it's voluntary. You don't have to have your name on the
list. Anyone who wants to put their name down as the shepherd of a
plugin is saying they will keep the plugin in their mind. They won't
necessarily do the work, they may not even be a coder, but they just
keep it in mind. For example, caching gets introduced in core, the
shepherd might think about whether there are any opportunities for
caching in their flock and raise it on -dev, #habari, or open a
ticket. It doesn't stop anyone submitting a patch to enable caching or
opening a ticket.
This isn't the only issue though, the tagging and testing are
important too.
[snip other points]
> > We could be very clear about the fact that this is _not_ someone who
> > is responsible for "protecting" the code, and the code in no way
> > belongs to them.
>
> Yes, that is perhaps my biggest concern - that 1) folks aren't
> intimidated away from working on it, and 2) people don't get offended
> when someone else works on "their" code.
We just need to be clear on that. It isn't their code. I'm not saying
tickets must be submitted to the shepherd, or that tickets submitted
will be automatically owned by the shepherd.
> -----Original Message-----
> From: habar...@googlegroups.com [mailto:habar...@googlegroups.com]
> On Behalf Of Michael C. Harris
> Sent: 28. april 2008 08:43
> To: habar...@googlegroups.com
> Subject: [habari-dev] Re: Plugins directory
>
>