Re: [libreoffice-website] Documentation framework for LibreOffice?

2010-10-30 Thread Sophie Gautier
Hi Andreas,

On Sat, Oct 30, 2010 at 10:40 AM, Andreas Mantke ma...@gmx.de wrote:
 Hi all,

 the documentation for LibreOffice and OOo is currently created via wiki and 
 the
 OOoAuthors.org site (a Plone CMS with a workflow). The finished 
 documentations were
 currently published on OOoAuthors.org, the wiki and on the OOo-Website.

 I wonder, in which way we want to create documentation (howto, books etc.) for
 LibreOffice. Should we do that on the wiki or should we set up a framework (a 
 CMS
 with a special workflow) at one of our resources.

 If we want to use a CMS, we had to decide, if we want to use Plone, which 
 some of the
 documentation-contributors already know, or another CMS (Drupal, Alfresco 
 etc.). I
 don't know at the moment, if the letter ones fullfill all of the needs of the
 contributors for documentation, because i only worked with Plone.

 I raise this topic on this list, because i want to discuss only the technical 
 aspects
 first. If there is no need to think about another framework / CMS, because 
 all needed
 features are available, then a discussion of this topic on the documentation 
 list is
 unnecessary.

 I want only to know, if a CMS is projected for this topic and if it is planed 
 about
 the available (or intended) features of that CMS. But i don't want to create 
 a new
 CMS-war or something else ;-)

May be we could discuss the needs on the documentation list, come back
here with some details and see where they fit in the CMS discussion
happening here. In my dreams, I would like to be able to use my
translation tools (and my translation memory) to deal with the
documentation, but may be this is not true for the other teams. Would
you like to open this discussion on the documentation list?

Kind regards
Sophie
-- 
Founding member of The Document Foundation

-- 
E-mail to website+h...@libreoffice.org for instructions on how to unsubscribe
List archives are available at http://www.libreoffice.org/lists/website/
All messages you send to this list will be publicly archived and cannot be 
deleted



Re: [libreoffice-website] Documentation framework for LibreOffice?

2010-10-30 Thread Andreas Mantke
Hi Sophie, *,

Am Samstag, 30. Oktober 2010, 11:44:26 schrieb Sophie Gautier:
 Hi Andreas,
(...)
 May be we could discuss the needs on the documentation list, come back
 here with some details and see where they fit in the CMS discussion
 happening here. In my dreams, I would like to be able to use my
 translation tools (and my translation memory) to deal with the
 documentation, but may be this is not true for the other teams. Would
 you like to open this discussion on the documentation list?

done ;-)

Regards,
Andreas
-- 
## Developer LibreOffice
## Freie Office-Suite für Linux, Mac, Windows
## http://LibreOffice.org
## Support the Document Foundation (http://documentfoundation.org)
## Meine Seite: http://www.amantke.de 

--
E-mail to website+h...@libreoffice.org for instructions on how to unsubscribe
List archives are available at http://www.libreoffice.org/lists/website/
All messages you send to this list will be publicly archived and cannot be 
deleted



Re: [libreoffice-website] Documentation framework for LibreOffice?

2010-10-30 Thread Christian Lohmaier
Hi Andreas, *,

On Sat, Oct 30, 2010 at 10:40 AM, Andreas Mantke ma...@gmx.de wrote:
 [OOoAuthors platfrom for LO]

 If we want to use a CMS, we had to decide, if we want to use Plone, which 
 some of the
 documentation-contributors already know, or another CMS (Drupal, Alfresco 
 etc.). I
 don't know at the moment, if the letter ones fullfill all of the needs of the
 contributors for documentation, because i only worked with Plone.

I don't really have an idea about how the workflow works in plone, and
what the requirements are, but I can say that when the originating
document format (the format that is worked with) is not HTML, then
silverstripe is not suitable (not out of the box that is).

 I want only to know, if a CMS is projected for this topic and if it is planed 
 about
 the available (or intended) features of that CMS. But i don't want to create 
 a new
 CMS-war or something else ;-)

Well - I always advocated the special tool for special needs
philosophy (wiki extra, forums extra) so I surely don't have
objections against an extra authors-instance.

But it would help to lay out the requirements, so that those who are
setting up the drupal demo/prototoype can have a look at it.

ciao
Christian

-- 
E-mail to website+h...@libreoffice.org for instructions on how to unsubscribe
List archives are available at http://www.libreoffice.org/lists/website/
All messages you send to this list will be publicly archived and cannot be 
deleted



Re: [libreoffice-website] Documentation framework for LibreOffice?

2010-10-30 Thread Benjamin Horst
Hi Andrea,

On Oct 30, 2010, at 7:42 AM, Andrea Pescetti wrote:
 Andreas Mantke wrote:
 If we want to use a CMS, we had to decide, if we want to use Plone, which 
 some of the documentation-contributors already know, or another CMS (Drupal, 
 Alfresco etc.)
 
 I never used the OOoAuthors structures intensively, but recently the Italian 
 OpenOffice.org documentation team expressed their desire to see the 
 infrastructure upgraded to Plone 4, for performance reasons. So they they 
 were thinking of a vertical Plone to Plone migration rather than a complete 
 migration, and I think the same would apply to documentation for LibreOffice.

Plone is a good CMS, and if it works well for the documentation team, then it 
makes sense to continue using it. However, I know the focus of the OOoAuthors 
project has been to produce PDFs and printed books, but there is a good reason 
to also work on thorough, online, HTML documentation for LibO in the future. 
(We do have the documentation wiki already: 
http://wiki.services.openoffice.org/wiki/Documentation/ )

If you're interested in online Drupal documentation, the best example I can 
recommend is the Drupal site's documentation itself: 
http://drupal.org/documentation

Both in terms of workflow and final output, it meets the needs I think we have 
for LibO. From a user perspective, hosting it at an easy URL like 
libreoffice.org/documentation would be very important, and thus it should be 
integrated into our core CMS.

-Ben

Benjamin Horst
bho...@mac.com
646-464-2314 (Eastern)
www.solidoffice.com


-- 
E-mail to website+h...@libreoffice.org for instructions on how to unsubscribe
List archives are available at http://www.libreoffice.org/lists/website/
All messages you send to this list will be publicly archived and cannot be 
deleted