Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |Owner:  massimo
 Type:  PLIP   |   Status:  closed 
 Priority:  n/a|Milestone:  Future 
Component:  Documentation  |   Resolution:  wontfix
 Keywords: |  
---+
Changes (by rossp):

  * status:  new => closed
  * resolution:  => wontfix


Comment:

 PLEASE READ THIS AND RE-OPEN VALID PLIPS!

 As we launch the new PLIP process we'd like to see which PLIPs:

 - are still appropriate/needed
 - still have owners/proposers/champions
 - still have available implementers

 If this PLIP should still be considered for future releases of Plone
 please do re-open this ticket and assign an appropriate milestone.  If it
 should be considered for the next release of Plone, use the 4.2 milestone.
 Also be sure to update the PLIP description, requester, owner, etc. and
 include a comment detailing recent progress and new plans.  We will use
 all these details in the new continuous PLIP process.

-- 
Ticket URL: 
Plone 
Plone Enterprise Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
https://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  Future 
Component:  Documentation  |Keywords: 
---+
Changes (by esteele):

  * milestone:  4.1 => Future


-- 
Ticket URL: 
Plone 
Plone Enterprise Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
https://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by alecm):

 Thanks for taking the time to file issues based on the reviews and
 beginning discussion there.  It's great to see you've already fixed some
 of the technical issues and are thinking about the broader issues.  Having
 high quality tutorials is the goal of this PLIP though, so issues
 regarding the tutorial appropriateness and quality will need to be weighed
 very heavily.

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by massimo):

 Thanks Alec and Matthew for the work done!
 I moved all the remarks made here:
 https://launchpad.net/collective.amberjack/+milestone/1.1.1

 some of the are already set to someone that will fix them, others need to
 be deeply discussed.
 I would ask both Alec and Matthew to check them and tell me their
 thoughts.

 it seems to me that the most important issues are:
  * https://bugs.launchpad.net/collective.amberjack/+bug/697359 (see reply)
  * https://bugs.launchpad.net/collective.amberjack/+bug/697347 (see reply)
  * https://bugs.launchpad.net/collective.amberjack/+bug/697338 (we need to
 do more)
  * https://bugs.launchpad.net/collective.amberjack/+bug/697335 (we
 probably need help from documentation team)

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by alecm):

 Discussion of the reviews belongs either here in Trac or on the Framework
 Team mailing list.  Note that Matthew Wilkes has also written a review of
 the PLIP, which is available in SVN.

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by massimo):

 fixed the problem reported by timo.

 what should I do with the alec's review? he suggested several things,
 should I reply here?

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by alecm):

 (In [46011]) Initial review of PLIP 9324 (collective.amberjack).  Refs
 #9324

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by timo):

 There seems to be a problem with the current buildout:

 {{{
 ./bin/buildout -c plips/plip9324-collective.amberjack.cfg
 }}}

 {{{
 t...@rudolf:~/workspace/plone/plone-4.1-coredev$ ./bin/instance fg
 2010-11-27 13:59:05 INFO ZServer HTTP server started at Sat Nov 27
 13:59:05 2010
 Hostname: 0.0.0.0
 Port: 8080
 
/home/timo/.buildout/eggs/Products.CMFCore-2.2.2-py2.6.egg/Products/CMFCore/FSObject.py:21:
 DeprecationWarning: RoleManager is deprecated. RoleManager is no longer
 part of AccessControl, please depend on Zope2 and import from OFS.role or
 use the new minimal RoleManager class from AccessControl.rolemanager.
   from AccessControl.Role import RoleManager
 2010-11-27 13:59:08 INFO ZODB.blob (5508) Blob directory
 `/home/timo/workspace/plone/plone-4.1-coredev/plips/../var/blobstorage` is
 unused and has no layout marker set. Selected `bushy` layout.
 2010-11-27 13:59:08 INFO ZODB.blob (5508) Blob temporary directory
 '/home/timo/workspace/plone/plone-4.1-coredev/plips/../var/blobstorage/tmp'
 does not exist. Created new directory.
 2010-11-27 13:59:08 WARNING ZODB.blob (5508) Blob dir
 /home/timo/workspace/plone/plone-4.1-coredev/var/blobstorage/ has insecure
 mode setting
 Traceback (most recent call last):
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/Startup/run.py",
 line 72, in 
 run()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/Startup/run.py",
 line 21, in run
 starter.prepare()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/Startup/__init__.py",
 line 86, in prepare
 self.startZope()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/Startup/__init__.py",
 line 259, in startZope
 Zope2.startup()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/__init__.py", line
 47, in startup
 _startup()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/App/startup.py",
 line 118, in startup
 load_zcml()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/App/startup.py",
 line 52, in load_zcml
 load_site()
   File
 "/home/timo/.buildout/eggs/Zope2-2.13.0-py2.6.egg/Zope2/App/zcml.py", line
 46, in load_site
 _context = xmlconfig.file(site_zcml)
   File
 
"/home/timo/.buildout/eggs/zope.configuration-3.7.2-py2.6.egg/zope/configuration/xmlconfig.py",
 line 653, in file
 context.execute_actions()
   File
 
"/home/timo/.buildout/eggs/zope.configuration-3.7.2-py2.6.egg/zope/configuration/config.py",
 line 606, in execute_actions
 callable(*args, **kw)
   File
 
"/home/timo/.buildout/eggs/AccessControl-2.13.3-py2.6-linux-i686.egg/AccessControl/security.py",
 line 165, in protectClass
 permission = getUtility(IPermission, name=permission_id)
   File
 
"/home/timo/.buildout/eggs/zope.component-3.9.5-py2.6.egg/zope/component/_api.py",
 line 169, in getUtility
 raise ComponentLookupError(interface, name)
 zope.configuration.config.ConfigurationExecutionError: : (, 'cmf.ManagePortal')
   in:
   File
 
"/home/timo/workspace/plone/plone-4.1-coredev/src/collective.amberjack.core/collective/amberjack/core/configure.zcml",
 line 84.2-89.8
 
 }}}

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |   Owner:  massimo
 Type:  PLIP   |  Status:  new
 Priority:  n/a|   Milestone:  4.1
Component:  Documentation  |Keywords: 
---+

Comment(by massimo):

 we released the 1.1 version
 (https://launchpad.net/collective.amberjack/+milestone/1.1)

 We also added a brief description in the plips directory:
 http://svn.plone.org/svn/plone/buildouts/plone-
 coredev/branches/4.1/plips/plip9324-collective.amberjack.txt

 let me know if something more is needed

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |Owner:  massimo
 Type:  PLIP   |   Status:  new
 Priority:  n/a|Milestone:  4.1
Component:  Documentation  |   Resolution: 
 Keywords: |  
---+

Comment(by amleczko):

 (In [40109]) Buildout for collective.amberjack suite. Refs #9324

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |Owner:  massimo
 Type:  PLIP   |   Status:  new
 Priority:  n/a|Milestone:  4.1
Component:  Documentation  |   Resolution: 
 Keywords: |  
---+

Comment(by esteele):

 Your PLIP has been accepted for consideration for Plone 4.1.

 Framework Team voting on this PLIP was:
 Alec+1
 Craig   +1
 Elizabeth   +1
 Laurence+1
 Martijn +1
 Matthew +1
 Rob +1
 Ross--

 The initial implementation deadline for your PLIP is October 1st, 2010.
 The Framework Team would certainly appreciate you finishing beforehand so
 that they may begin evaluating it as soon as possible. Announce its
 readiness here once your implementation is ready for review.

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |Owner:  massimo
 Type:  PLIP   |   Status:  new
 Priority:  n/a|Milestone:  4.1
Component:  Documentation  |   Resolution: 
 Keywords: |  
---+
Changes (by massimo):

  * owner:  sknox => massimo
  * status:  assigned => new


Old description:

> '''Proposer:''' Alexander Limi[[BR]]
> '''Seconder:''' Nate Aune[[BR]]
> [[BR]]
> == Motivation ==
> Getting started after installing Plone is currently one of our main user
> experience problems. The "what do I do now?" question isn't really
> answered, and people find it hard to get started with basic content
> editing, publishing, and other simple tasks.
>
> There's an LGPLed product out there that uses a JS overlay to guide you
> through operating any web site without interfering with the original
> HTML, called [http://www.amberjack.org Amberjack]. We propose using
> Amberjack to create these guided tours for people new to Plone.
>
> There are lots of great things about Amberjack, some of which are:
>  * Uses standard HTML files for the guided help, which means we can apply
> ZPT for dynamic substitutions where needed, and most importantly: use
> i18n tags to have the guided help in the user's own language!
>  * Doesn't rely on the Plone theme in any way, so works equally well on
> sites that have another theme applied.
>  * Can fill in information for the user, so they don't have to type in
> stuff manually to test things — and lets you split up something like an
> edit form into several steps that are done one at a time.
>
> For more information about Amberjack, please have a look at:
>  * [http://www.slideshare.net/Jazkarta/amberjack-lightning-talk Nate's
> lightning talk about collective.amberjack] — this has much more info on
> the technical implementation and capabilities, recommended before you
> read the rest of this PLIP!
>  * The [http://www.amberjack.org Amberjack web site]
>
> == Assumptions ==
> In general, I'd say that this package shouldn't be in core Plone as such,
> but probably be standard issue in the installers. People building their
> own setups via buildout shouldn't have to worry about removing this from
> every setup they create. On the other hand, adding it in should be a
> simple matter of adding the relevant egg(s) to buildout.
>
> I'm also aware that this PLIP is a bit thin on the implementer side at
> the moment (because of time pressure), but the upside of this effort is
> that if it doesn't happen, it's not part of the core Plone package, but
> only ships with installers. If it doesn't materialize in time, we can
> always add it in later, similar to how we do incremental improvements to
> the installer itself.
>
> I still hope this PLIP is worth serious consideration, especially since
> the implementation is already available as a standalone product, and it
> solves one of the fundamental user experience issues we have currently.
>
> == Proposal & Implementation ==
> The major part of this project already exists in the collective.amberjack
> product. In addition to some refinements to the existing product, the
> majority of the implementation would consist of:
>  * Getting feedback from experienced integrators and trainers on which
> scripts to include
>  * Write up concise, short, to-the-point HTML documents walking people
> through these use cases
>  * Get these documents ready and annotated with i18n tags in time for the
> translators to complete translated tours for their language
>
> == Deliverables ==
>  * A refined version of collective.amberjack that fixes some of the minor
> Amberjack UI issues
>  * A collection of walkthrough scripts implemented in the HTML format
> that Amberjack uses
>  * Fully marked up with i18n tags, it can be translated into our shipping
> languages
>  * Translations to the majority of our shipping languages
>
> == Risks ==
>  * It puts a slightly larger burden on our translators, as there will be
> more strings to translate.
>  * Special care has to be taken to make sure we don't intermingle this
> product in a way that affects Plone core. Shouldn't be a problem, but is
> worth noting. :)
>
> == Participants ==
> The current module owners from the Sorrento '09 and Bolzano '08 sprints
> are:
>
>  * Massimo
>  * Stefano
>  * Harito
>  * Giorgio
>  * Daniel
>
> I am still in the process of checking if any of them are willing to
> shepherd this into the Plone 4 installers.
>
> On the "which things should we teach people to do" side of things, I
> volunteer myself to help identify where to focus our efforts — I will
> probably mostly be collecting feedback from people like Joel Burton and
> Jon Stahl, since these people have extensive experience with what people
> are struggling with, and commo

Re: [PLIP-Advisories] [Plone] #9324: Use Amberjack to offer guided help for first-time users

[Change notifications for Plone PLIPs on Trac.]

#9324: Use Amberjack to offer guided help for first-time users
---+
 Reporter:  limi   |Owner:  sknox   
 Type:  PLIP   |   Status:  assigned
 Priority:  n/a|Milestone:  4.1 
Component:  Documentation  |   Resolution:  
 Keywords: |  
---+
Changes (by limi):

  * milestone:  4.x => 4.1


Comment:

 As far as I know, we're going to try to get this in for 4.1.

-- 
Ticket URL: 
Plone 
Plone Content Management System
___
PLIP-Advisories mailing list
plip-advisor...@lists.plone.org
http://lists.plone.org/mailman/listinfo/plip-advisories