[Plone-docs] Collective developer manul update

[Mikko Ohtamaa]

Hi,

Here is the status update for collective development documentation

- New content update to plone.org was performed today
http://plone.org/documentation/manual/plone-community-developer-documentation

- All Sphinx errors and warnings have been fixed in the source

- The manual went through of quick inspection and I merged / fixed some
documents

- Descriptions are now correctly place on the pages (if available)

- There is open issue with plone.org and code example
http://www.coactivate.org/projects/deliverance/lists/deliverance-discussion/archive/2010/07/1279390563961/forum_view

- New Sphinx CSS should be updated to plone.org (curretly done
through-the-web in Zope)
https://svn.plone.org/svn/collective/collective.developermanual/trunk/sphinx.css
I don't have rights.

- Issue with .html extension in URI has been resolved

After the XDV / <pre> formatting issue has been solved I suggest you will
set RedirectRule to all places where the developer manual documentation has
been lying around ( collective-docs.plone.org )




-----
Mikko Ohtamaa
mFabrik - Freedom Delivered.

Web site - http://mfabrik.com
Mobile site - http://mfabrik.mobi
Blog - http://blog.mfabrik.com

[Israel Saeta Pérez]

Hi Mikko,

Post by Mikko Ohtamaa
Hi,
Here is the status update for collective development documentation
- New content update to plone.org was performed today
http://plone.org/documentation/manual/plone-community-developer-documentation
- All Sphinx errors and warnings have been fixed in the source
- The manual went through of quick inspection and I merged / fixed some
documents
- Descriptions are now correctly place on the pages (if available)

All this is awesome! Should we/I post a message to the plone mailing
lists to encourage people to contribute to this manual whenever they can?

Post by Mikko Ohtamaa
- There is open issue with plone.org and code example
http://www.coactivate.org/projects/deliverance/lists/deliverance-discussion/archive/2010/07/1279390563961/forum_view
- New Sphinx CSS should be updated to plone.org (curretly done
through-the-web in Zope)
https://svn.plone.org/svn/collective/collective.developermanual/trunk/sphinx.css
I don't have rights.

I created a PloneOrg branch and placed the sphinx.css file there:
http://svn.plone.org/svn/plone/Products.PloneOrg/branches/dukebody-sphinx-integration/Products/PloneOrg/skins/ploneorg/sphinx.css

Alex Clark know about this, so I hope he will merge this in the next
plone.org upgrade (possibly after switching to Plone 4).

Post by Mikko Ohtamaa
- Issue with .html extension in URI has been resolved
After the XDV /<pre> formatting issue has been solved I suggest you will
set RedirectRule to all places where the developer manual documentation has
been lying around ( collective-docs.plone.org )

You can ask/bug Laurence Rowe directly about it. :)

-- israel

[Mikko Ohtamaa]

Post by Israel Saeta Pérez
You can ask/bug Laurence Rowe directly about it. :)

Laurence kindly fixed this bug and it is now working.

I had to do minor changes to sphinx.css. The file has been committed to
Products.PloneOrg and waits loading to plone.org.

After that I can announce my work here done :)

-Mikko


-----
Mikko Ohtamaa
mFabrik - Freedom Delivered.

Web site - http://mfabrik.com
Mobile site - http://mfabrik.mobi
Blog - http://blog.mfabrik.com

[Mikko Ohtamaa]

Post by Mikko Ohtamaa

Post by Israel Saeta Pérez
You can ask/bug Laurence Rowe directly about it. :)

After that I can announce my work here done :)

Premature comment - looks like there is problem with index.html files
uploaded to PloneHelpCenter. They contain broken links (because those links
have .html extension which we are now stripping away).

The solution is not to upload index.html files as PloneHelpCenter does not
need them any case - it builds its own index pages automatically.

But expect people complaining a week or so before we get the problem fixed.

Cheers,
Mikko

-----
Mikko Ohtamaa
mFabrik - Freedom Delivered.

Web site - http://mfabrik.com
Mobile site - http://mfabrik.mobi
Blog - http://blog.mfabrik.com

[Alex Clark]

Hi Israel,

Post by Israel Saeta Pérez
Hi Mikko,

Post by Mikko Ohtamaa
Hi,
Here is the status update for collective development documentation
- New content update to plone.org was performed today
http://plone.org/documentation/manual/plone-community-developer-documentation
- All Sphinx errors and warnings have been fixed in the source
- The manual went through of quick inspection and I merged / fixed some
documents
- Descriptions are now correctly place on the pages (if available)

All this is awesome! Should we/I post a message to the plone mailing
lists to encourage people to contribute to this manual whenever they can?

Post by Mikko Ohtamaa
- There is open issue with plone.org and code example
http://www.coactivate.org/projects/deliverance/lists/deliverance-discussion/a
rchive/2010/07/1279390563961/forum_view
- New Sphinx CSS should be updated to plone.org (curretly done
through-the-web in Zope)
https://svn.plone.org/svn/collective/collective.developermanual/trunk/sphinx.
css
I don't have rights.

http://svn.plone.org/svn/plone/Products.PloneOrg/branches/dukebody-sphinx-inte
gration/Products/PloneOrg/skins/ploneorg/sphinx.css
Alex Clark know about this, so I hope he will merge this in the next
plone.org upgrade (possibly after switching to Plone 4).

Actually can you merge that down to trunk please? With RC1 around the corner
I expect to be shamed in to make some PloneOrg progress Real Soon Now

IOW, I'm not really planning any more 3.3.5 updates and PloneOrg trunk is
for Plone 4.


Alex

Post by Israel Saeta Pérez

Post by Mikko Ohtamaa
- Issue with .html extension in URI has been resolved
After the XDV /<pre> formatting issue has been solved I suggest you will
set RedirectRule to all places where the developer manual documentation has
been lying around ( collective-docs.plone.org )

You can ask/bug Laurence Rowe directly about it. :)
-- israel
------------------------------------------------------------------------------
This SF.net email is sponsored by Sprint
What will you do first with EVO, the first 4G phone?
Visit sprint.com/first -- http://p.sf.net/sfu/sprint-com-first

[Israel Saeta Pérez]

Post by Alex Clark
Hi Israel,

Post by Israel Saeta Pérez
Alex Clark know about this, so I hope he will merge this in the next
plone.org upgrade (possibly after switching to Plone 4).

Actually can you merge that down to trunk please? With RC1 around the corner
I expect to be shamed in to make some PloneOrg progress Real Soon Now�
IOW, I'm not really planning any more 3.3.5 updates and PloneOrg trunk is
for Plone 4.

Uhm, looks like I had already done the merge, but I didn't remember :P
http://dev.plone.org/plone/changeset/37457

-- israel