Scope of Framework Team

9 messages Options
Embed this post
Permalink
Raphael Ritz

Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
[Sorry if this gets through twice; I'm resending because
I still don't see the message that I've sent out this morning]

Hi,

yesterday, our current FWT for Plone 4.0 discussed all
submitted PLIPs when an interesting question came up that
we'd like some feedback on from our developer community
at large.

First, let's look at some PLIPs and their rational:

http://dev.plone.org/plone/ticket/9250:
"We propose to include the jQuery Tools library in
the base Plone install." -> one reason being to
give recommendations to people what to use when
doing advanced JQ stuff

http://dev.plone.org/plone/ticket/9314:
"Provide in the installers an installation option
[..] to load a common development environment."
-> give recommendation on what 3rd-party add-ons
to use while developing

http://dev.plone.org/plone/ticket/9324:
"We propose using Amberjack to create [these]
guided tours for people new to Plone."
-> give recommendation on what 3rd-party tool
to use to support a certain feature

Note that this PLIP also states:
"In general, I'd say that this package shouldn't
be in core Plone as such, but probably be standard
issue in the installers."


What all these PLIPs have in common is that they propose
the Plone (core?) distribution should give recommendations
on additional software - not shipping with Plone as such -
to use for certain use cases.
Two of those explicitly address the installers rather than
the Plone core code itself.

The question we have is simply put:
Are people comfortable with the FWT making decisions here?

And maybe more importantly:
Where do we draw the line?

By that I mean: once we start "blessing" add-ons how should
we react if in the next round somebody proposes to include
product X for feature Y in the installer?
I'm not sure I would feel comfortable (as a FWT member) if
that became a pattern.

Do people see what I mean?
Is it maybe a non-issue?
Should we consider defining some sort of policy here?
Do we maybe need something else to come up with
"recommended best practices to do X"?

Opinions anyone?

Thanks for listening,

     Raphael







------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Wichert Akkerman

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
On 7/1/09 4:47 PM, Raphael Ritz wrote:

> What all these PLIPs have in common is that they propose
> the Plone (core?) distribution should give recommendations
> on additional software - not shipping with Plone as such -
> to use for certain use cases.
> Two of those explicitly address the installers rather than
> the Plone core code itself.
>
> The question we have is simply put:
> Are people comfortable with the FWT making decisions here?

I'm not sure I'm very comfortable with the idea of having the standard
official installer install much more than a core Plone install. Doing
that means the definition of what Plone is becomes less clear, and we
are suddenly entering the business of making recommendations, which I do
not think we should be doing.

I would much rather see a simpler way for people to find and install
add-ons instead.

Wichert.

------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Hanno Schlichting-4

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
In reply to this post by Raphael Ritz
On Wed, Jul 1, 2009 at 4:47 PM, Raphael
Ritz<[hidden email]> wrote:
> What all these PLIPs have in common is that they propose
> the Plone (core?) distribution should give recommendations
> on additional software - not shipping with Plone as such -
> to use for certain use cases.
> Two of those explicitly address the installers rather than
> the Plone core code itself.
>
> The question we have is simply put:
> Are people comfortable with the FWT making decisions here?

I think the framework team should be responsible for watching over the
Plone core distribution as much as all the different official
installers. So if anyone wants to add anything substantial into the
installers this ought to have a PLIP and follow our normal process.

Having the responsibility for this on Steve, Sidnei or Alan alone
doesn't sound right to me.

> By that I mean: once we start "blessing" add-ons how should
> we react if in the next round somebody proposes to include
> product X for feature Y in the installer?

I'd say that we should be very careful to not let the installers and
stand-alone distribution differ too much. Personally I can see an
extension of the "dev-pack" (especially since we already have it) as
something that is worth putting into the installer.

Apart from this kind of "setting up the environment" stuff I think
there should be no code or feature differences between the various
distribution options.

So if we don't see a need for "jQuery Tools" in the core distribution,
than it doesn't ship with any of the official distribution formats we
have - period. And it's the framework teams job to decide about what
gets in and what stays out.

We do have the choice of including things into Plone Core as "shipped
but disabled" like we do with OpenID and iterate today and I'm
planning to extend this approach to some more packages to allow a more
slimmed-down version of Plone for people that need it. The number of
packages that get this treatment should be constrained to a very
limited number however.

Finding and blessing random add-ons is not part of the framework teams job.

Hanno

------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Steve McMahon

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
In reply to this post by Wichert Akkerman
Replying to Wichert's point on installers:

To me, the installers are all about convenience and recommended practices. Paster/ZopeSkel fill the role of providing a narrow core install.

Things the installers already do that go well beyond a core install:

1) Provide a visual controller for Windows and OS X;

2) Create uids under which to run daemons and set file permissions to match on *nix. Optionally install a service on Windows or startup script on OS X;

3) Provide options for ZEO or standalone installs; provide a model for a sensible way to clone clients with ZEO.

If we agree that installers should do this sort of convenience work, then the question might be: "who decides what the installers should do?" That could be the installers team, and that might not be a bad thing. But, bringing the issues up via PLIP allows for very open, public discussion.

Steve


On Wed, Jul 1, 2009 at 7:54 AM, Wichert Akkerman <[hidden email]> wrote:
On 7/1/09 4:47 PM, Raphael Ritz wrote:

> What all these PLIPs have in common is that they propose
> the Plone (core?) distribution should give recommendations
> on additional software - not shipping with Plone as such -
> to use for certain use cases.
> Two of those explicitly address the installers rather than
> the Plone core code itself.
>
> The question we have is simply put:
> Are people comfortable with the FWT making decisions here?

I'm not sure I'm very comfortable with the idea of having the standard
official installer install much more than a core Plone install. Doing
that means the definition of what Plone is becomes less clear, and we
are suddenly entering the business of making recommendations, which I do
not think we should be doing.

I would much rather see a simpler way for people to find and install
add-ons instead.

Wichert.

------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers



--

Steve McMahon
Reid-McMahon, LLC
[hidden email]
[hidden email]

------------------------------------------------------------------------------

_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Wichert Akkerman

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
On 7/1/09 5:15 PM, Steve McMahon wrote:

> Replying to Wichert's point on installers:
>
> To me, the installers are all about convenience and recommended
> practices. Paster/ZopeSkel fill the role of providing a narrow core install.
>
> Things the installers already do that go well beyond a core install:
>
> 1) Provide a visual controller for Windows and OS X;
>
> 2) Create uids under which to run daemons and set file permissions to
> match on *nix. Optionally install a service on Windows or startup script
> on OS X;
>
> 3) Provide options for ZEO or standalone installs; provide a model for a
> sensible way to clone clients with ZEO.

I consider all of these to be a minimal implementation of a "perform a
basic install of Plone". To be more precise: I consider them to be a
version of the basic ZopeSkel-installation for non-developers.

The installers do not install extra add-on packages, extra documentation
or provide anything else that is not included in the Plone core
distribution.


Wichert.

------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Raphael Ritz

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
Wichert Akkerman wrote:

[..]

>
> The installers do not install extra add-on packages, extra documentation
> or provide anything else that is not included in the Plone core
> distribution.

While that's correct for todays installers this would change if
we accepted the aforementioned PLIPs.

Also - in light of buildout - it is much easier now to sort of
include something without shipping with it - simply by putting
a few eggs in the cfg file but comment them out and say: "if you
want XYZ uncomment the following line(s)".

Don't get me wrong. I do appreciate the recommendations given for
the development environment and I'm also perfectly fine with saying
this is a special case that we consider OK to be included.

But since it starts right now to possibly expand I wanted to bring
this up in front of a larger audience to see where people want this
to be heading.

Raphael

>
>
> Wichert.
>
> ------------------------------------------------------------------------------


------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Alexander Limi

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
In reply to this post by Raphael Ritz
On Wed, 01 Jul 2009 07:47:48 -0700, Raphael Ritz  
<[hidden email]> wrote:

> First, let's look at some PLIPs and their rational:
>
> http://dev.plone.org/plone/ticket/9250:
> "We propose to include the jQuery Tools library in
> the base Plone install." -> one reason being to
> give recommendations to people what to use when
> doing advanced JQ stuff

The intention was also to start using this in Plone core. We need a  
solution for the problems that jQuery Tools solve (modal dialogs, for  
one), and currently we have no standard solution for this. It's a bit like  
saying "implement your own file picker" in an operating system, it's a bad  
idea to not have a standard that everyone can use.

> http://dev.plone.org/plone/ticket/9314:
> "Provide in the installers an installation option
> [..] to load a common development environment."
> -> give recommendation on what 3rd-party add-ons
> to use while developing

I think having the installers have the option to install dev tools  
(disabled by default) is the same as having them commented out in the  
standard buildout. I don't see a problem here.

> http://dev.plone.org/plone/ticket/9324:
> "We propose using Amberjack to create [these]
> guided tours for people new to Plone."
> -> give recommendation on what 3rd-party tool
> to use to support a certain feature

I think this is a "must have" for Plone if we're going to solve the  
largest usability problem we have now: "what to do next". Installing Plone  
is now something that works great for people 99% of the time, so next up  
is solving the discoverability problem of how to use Plone.

The reason I proposed putting this in the installers only, was to avoid  
having the "but I don't want that in core Plone" for the people that  
deploy Plone for their customers. You shouldn't have to disable it  
explicitly when you create your own deployment, and it's not a hard  
dependency. But I really think it's a core requirement to not lose all the  
people that install Plone and then don't know what to do — which is very  
common according to our uninstall feedback.


--
Alexander Limi · http://limi.net


------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Alexander Limi · http://limi.net

Wichert Akkerman

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
On 7/2/09 12:19 AM, Alexander Limi wrote:

> On Wed, 01 Jul 2009 07:47:48 -0700, Raphael Ritz
> <[hidden email]>  wrote:
>
>> First, let's look at some PLIPs and their rational:
>>
>> http://dev.plone.org/plone/ticket/9250:
>> "We propose to include the jQuery Tools library in
>> the base Plone install." ->  one reason being to
>> give recommendations to people what to use when
>> doing advanced JQ stuff
>
> The intention was also to start using this in Plone core. We need a
> solution for the problems that jQuery Tools solve (modal dialogs, for
> one), and currently we have no standard solution for this. It's a bit like
> saying "implement your own file picker" in an operating system, it's a bad
> idea to not have a standard that everyone can use.

Then lets have this discussion at the moment when someone wants to
introduce code that uses jQuery Tools. What is the point of adding a
javascript library that we are not using ourselves at all at the moment?

>> http://dev.plone.org/plone/ticket/9324:
>> "We propose using Amberjack to create [these]
>> guided tours for people new to Plone."
>> ->  give recommendation on what 3rd-party tool
>> to use to support a certain feature
>
> I think this is a "must have" for Plone if we're going to solve the
> largest usability problem we have now: "what to do next". Installing Plone
> is now something that works great for people 99% of the time, so next up
> is solving the discoverability problem of how to use Plone.

One thing that triggers my curiosity: I have never seen that claim
before. Can you explain where the user survey or feedback is where that
statement is derived from, and can we read that? And what are the other
common usability problems?

Wichert.

------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers
Raphael Ritz

Re: Scope of Framework Team

Reply Threaded More More options
Print post
Permalink
In reply to this post by Alexander Limi
Alexander Limi wrote:


Hi Alex,

actually I was trying to make a slightly different point
and using those PLIPs for illustration more than anything
else.

Let me try differently:
When discussing the developer add-ons now we see questions like
"Is it OK to include/recommend PDBDebugMode in there or is
it too intrusive?"

Again, I don't want to discuss this particular question here
but rather the fact whether the Framework Team should get
engaged in deciding this at all.

Reason being that we are crossing a line here because
we're not considering to include PDBDebugMode (to stick
to the example) in the core distribution (it won't get
there - period) but a recommendation on a specific
3rd-party add-on.

And while the general question "Should we support some
sort of developer pack?" seems to see a lot of support
(in fact we have it already) the questions are at least
also in those details.

Or again differently put:
When we review code for inclusion in Plone core we try
hard to make sure certain requirements are fulfilled.
Should we apply the same standards to those recommended
add-ons? (jQ tools, Amberjack, various dev packages)
Does that mean that we take on responsibility for
judging their quality above and beyond their usefulness
to us?

For me that makes a difference. While I feel comfortable
about the dev add-ons because I know (most of) them from
using them myself I would have a hard time figuring out
anything serious and reliable about Amberjacks standing.
And I admit right away that I'm far from being a
JS/jQ/jQT expert in order to judge whether this is the
best recommendation we could give. Yet I'm asking myself
whether I should care at all.

Again, I don't want to discuss any of those PLIPs specifically
here. I'd rather like to bring up the question that arises
from the possibilities we have now to distinguish between
"Plone core (the code)" and "Plone the distribution" (what
you get through the installers - directly or indirectly).

So far my understanding has been that the FWT is concerned
with the former (the code) but some of our current PLIPs
bring up the latter (the distribution). This is why I'm
asking what people consider the scope of the FWT to be.

Personally, I'm fine either way but I'd like us to know
what we are doing.

(Or maybe I'm just biased by being too deep in science and
politics in my day job that I see issues were there are none ..)

Raphael



> On Wed, 01 Jul 2009 07:47:48 -0700, Raphael Ritz  
> <[hidden email]> wrote:
>
>> First, let's look at some PLIPs and their rational:
>>
>> http://dev.plone.org/plone/ticket/9250:
>> "We propose to include the jQuery Tools library in
>> the base Plone install." -> one reason being to
>> give recommendations to people what to use when
>> doing advanced JQ stuff
>
> The intention was also to start using this in Plone core. We need a  
> solution for the problems that jQuery Tools solve (modal dialogs, for  
> one), and currently we have no standard solution for this. It's a bit like  
> saying "implement your own file picker" in an operating system, it's a bad  
> idea to not have a standard that everyone can use.
>
>> http://dev.plone.org/plone/ticket/9314:
>> "Provide in the installers an installation option
>> [..] to load a common development environment."
>> -> give recommendation on what 3rd-party add-ons
>> to use while developing
>
> I think having the installers have the option to install dev tools  
> (disabled by default) is the same as having them commented out in the  
> standard buildout. I don't see a problem here.
>
>> http://dev.plone.org/plone/ticket/9324:
>> "We propose using Amberjack to create [these]
>> guided tours for people new to Plone."
>> -> give recommendation on what 3rd-party tool
>> to use to support a certain feature
>
> I think this is a "must have" for Plone if we're going to solve the  
> largest usability problem we have now: "what to do next". Installing Plone  
> is now something that works great for people 99% of the time, so next up  
> is solving the discoverability problem of how to use Plone.
>
> The reason I proposed putting this in the installers only, was to avoid  
> having the "but I don't want that in core Plone" for the people that  
> deploy Plone for their customers. You shouldn't have to disable it  
> explicitly when you create your own deployment, and it's not a hard  
> dependency. But I really think it's a core requirement to not lose all the  
> people that install Plone and then don't know what to do — which is very  
> common according to our uninstall feedback.
>
>


------------------------------------------------------------------------------
_______________________________________________
Plone-developers mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/plone-developers