Discussion:
[Plone-docs] collective-docs deserves a prominent link on plone.org
Israel Saeta Pérez
2010-12-14 17:37:14 UTC
Permalink
I think we need to keep the plone.org copy for a eat our own dog food
stance plus so search works.
I think that is debatable, but I see your point. Personally, I'm not
going to champion that cause right now because I'm swamped. But you are
already doing all the work anyway ;-)
In general, I agree it's nice to be able to upload the c.developermanual
content to PHC. But I have "maintenance phobia" about a lot of Plone
infrastructure these days.
Is it confusing to keep both though?
Not IMHO. We have a few cases like this where some community member
argues for an alternate presentation of the same data (c.f. Wiggy and
the plone theme vs. trac theme debate of 2009).
Presentation and UI are important, and Sphinx gets it right IMHO
(elegant, simple, just works, does not get in the way, etc.)
Anyway, let's not forget the subject of this thread: displaying
c.developermanual prominently on http://plone.org/documentation (with a
link to
http://plone.org/documentation/manual/plone-community-developer-documentation)
Who can we get to do this? I nominate Jon Stahl! (Because I believe he
was the last one to re-org/cleanup that page).
We did some work during the conf:
http://plone.org/documentation/helpcenter_ploneorg2

Does this link fit here?

-- israel
Alex Clark
2010-12-14 19:09:30 UTC
Permalink
Post by Israel Saeta Pérez
I think we need to keep the plone.org copy for a eat our own dog food
stance plus so search works.
I think that is debatable, but I see your point. Personally, I'm not
going to champion that cause right now because I'm swamped. But you are
already doing all the work anyway ;-)
In general, I agree it's nice to be able to upload the c.developermanual
content to PHC. But I have "maintenance phobia" about a lot of Plone
infrastructure these days.
Is it confusing to keep both though?
Not IMHO. We have a few cases like this where some community member
argues for an alternate presentation of the same data (c.f. Wiggy and
the plone theme vs. trac theme debate of 2009).
Presentation and UI are important, and Sphinx gets it right IMHO
(elegant, simple, just works, does not get in the way, etc.)
Anyway, let's not forget the subject of this thread: displaying
c.developermanual prominently on http://plone.org/documentation (with a
link to
http://plone.org/documentation/manual/plone-community-developer-documentation)
Who can we get to do this? I nominate Jon Stahl! (Because I believe he
was the last one to re-org/cleanup that page).
http://plone.org/documentation/helpcenter_ploneorg2
Does this link fit here?
Cool! Can we deploy this?
Post by Israel Saeta Pérez
-- israel
------------------------------------------------------------------------------
Lotusphere 2011
Register now for Lotusphere 2011 and learn how
to connect the dots, take your collaborative environment
to the next level, and enter the era of Social Business.
http://p.sf.net/sfu/lotusphere-d2d
--
Alex Clark · http://aclark.net
Author · http://aclark.net/admin
Israel Saeta Pérez
2010-12-14 20:18:26 UTC
Permalink
Hi,
Post by Alex Clark
Post by Israel Saeta Pérez
http://plone.org/documentation/helpcenter_ploneorg2
Does this link fit here?
Cool! Can we deploy this?
It's live now. :) It's a template in the "custom" skin layer, but I
can move it to some layer in the PloneOrg product. Which one should I
place it into?

-- israel
Alex Clark
2010-12-14 20:22:12 UTC
Permalink
Post by Israel Saeta Pérez
Hi,
Post by Alex Clark
Post by Israel Saeta Pérez
http://plone.org/documentation/helpcenter_ploneorg2
Does this link fit here?
Cool! Can we deploy this?
It's live now. :) It's a template in the "custom" skin layer, but I
can move it to some layer in the PloneOrg product. Which one should I
place it into?
Well, it should go in PHC, and ideally have an entry in types.xml that
says the PHC object can select it as a default view.

Thanks!
Post by Israel Saeta Pérez
-- israel
------------------------------------------------------------------------------
Lotusphere 2011
Register now for Lotusphere 2011 and learn how
to connect the dots, take your collaborative environment
to the next level, and enter the era of Social Business.
http://p.sf.net/sfu/lotusphere-d2d
--
Alex Clark · http://aclark.net
Author · http://aclark.net/admin
Israel Saeta Pérez
2010-12-14 20:27:40 UTC
Permalink
Hi Alex,
Post by Alex Clark
Hi,
Post by Alex Clark
Post by Israel Saeta Pérez
http://plone.org/documentation/helpcenter_ploneorg2
Does this link fit here?
Cool! Can we deploy this?
It's live now. :)  It's a template in the "custom" skin layer, but I
can move it to some layer in the PloneOrg product. Which one should I
place it into?
Well, it should go in PHC, and ideally have an entry in types.xml that
says the PHC object can select it as a default view.
I don't think so, since this view doesn't make almost any sense
outside of plone.org (it's kind of harcoded). What I can do is to set
a normal phc view as default view in the PHC product, and place a
template with the same name in a skin layer in the PloneOrg product,
overriding this default view if it's higher up in the theme.

-- israel

Loading...