Please confirm that you want to play a YouTube video. By accepting, you will be accessing content from YouTube, a service provided by an external third party.
If you accept this notice, your choice will be saved and the page will refresh.
The LibreOffice project is made up of many communities working on different aspects of the software: source code, documentation, quality assurance, design and other matters. Some people are working full time, many others are volunteers, and we always try to make new contributors feel welcome.
So throughout October we’ll be running LibreOffice Community Weeks, looking at the different sub-projects in LibreOffice, what they do, and how to get involved. We start off this week by looking at the documentation project, and chat to Olivier Hallot, who is leading the effort to improve LibreOffice’s guide books and online help…
What is your role in the documentation project?
My role in the documentation project is to elaborate plans, coordinate and increase the collaboration of the community and improve the contents of the documentation of LibreOffice.
How did you get involved in LibreOffice?
I am involved in LibreOffice since its beginning, and even before during the OpenOffice.org times in 2001. In the last decade I had an active position in the Brazilian community as member of the BrOffice NGO, and also because I coordinated and translated OpenOffice.org’s User Interface and Help Content to Brazilian Portuguese, a task I carry on to date with LibreOffice. I also took job on OpenOffice.org migration consulting in very large companies in Brazil and later I participated in the creation of The Document Foundation (TDF) in 2010, being member of its Board of Directors from 2010 to early 2014.
Having an experience in the corporate arena, I was concerned that gap between the documentation and Help Content of LibreOffice with respect to its features was dangerously growing, and that has to be reverted so the software and its collateral documentation has to go ideally hand on hand. On presenting the issue in our LibOConf in Aarhus (Quo Vadis HelpContent?), TDF understood that it was necessary to take action and here I am.
What does your typical workday look like?
Since I live in Rio de Janeiro, Brazil, I must admit that when I wake up, people in Europe are already working full steam ahead and I have a feeling that I am always late and sleepy (laugh) in the job. Anyway, usually I check my mails just after my breakfast, and I get ready for the online meetings that for me are in the morning.
Then with the list of task from the meetings, which I cross-check with the off-line mails, I start at least one task to get it done in the day. That includes support in chats, answering e-mails in lists and off-list, and also updating a document, a wiki page or a web page.
You see, writing documentation on LibreOffice is a task that requires several hours or days of concentration and we must be focused all the time. To be able to write or review a specific feature, you must test the feature in your installation, understand the implication of the feature and even add some of your personal knowledge to give the reader a quality text and content.
How many people are involved in the doc project?
The doc project has two main lines: The literature and the Help content. The Help content is itself divided into contents and technology modernization.
On the literature, we are about three to five people contributing once in a while and this is an exposure. We need to update our books in timely fashion because they are considered as the official TDF books for LibreOffice and are translated into several languages. Since the license is Creative Commons, these books are also sources for other books on LibreOffice in many languages and communities.
On the help content, we have the valuable contribution of many individuals (from 10 to 20 persons), from translators to developers that help us to correct the contents and adjust the help pages to the new features and UI changes. The accuracy of the help pages is also an exposure we carry and our task is to close the gap. It must be noted that the correct description of a new feature is important for legacy purposes: if later on in the LibreOffice project, the feature does not work anymore, we still have a description of its existence and normal behavior.
Finally we consider that the current Help system, which is based on XML files transformed into HTML3.2 pages displayed as Writer/web documents can evolve to a modern browser-based technology. There are some tech issues yet to solve, especially because the Help system translation process is consolidated, works satisfactorily and its content must be preserved.
What’s been the biggest success so far, and the biggest challenge?
We updated the Getting Started Book to version 5.1 of LibreOffice, and we managed to put the help pages directly into a web server, at least as proof of concept, showing that we can evolve and achieve a better, richer help content.
My personal challenge is to produce the TDF LibreOffice Guides as a genuine companion product of the software, where the LibreOffice brand provides not only the software but also the collateral products for those migration or training professionals that support the deployment of LibreOffice in organizations.
I also pretend to close the distance between the user and the documentation. The usual way for the user is to hit F1 to get help but if the help is not enough, users go to Google and try a search for contents he is looking for. This is a time consuming task and we have already put entries in the software Help menu to link the software to the documentation website and to community forums. We expect an increase of visits to these services in benefit for our installed base.
But then the challenge is to get more contributors to help with documentation of LibreOffice, in all areas above. Authoring, reviewing and updating a book is a task that can be carried by non-developers, provided they have good knowledge in the software as advance user and have time do dedicate to the LibreOffice literature. The same is for the local communities if they want to translate LibreOffice books.
On the technology of the Help, the challenge is to select a viable technology to replace the current Help system.
What sort of help are you looking for?
We look for more contributors, people that can write, review, advanced contents on LibreOffice. It is important that we see the TDF LibeOffice Guides as a genuine companion product of the sofware, where TDF provides not only the software but also the collateral products for those professionals that support the deployment of LibreOffice in organizations.
Stay tuned to the blog for more about the documentation team this week – including a list of who’s who in the project, the tools being used, and how to get involved yourself! See here for more information on the docs team.
We have created a number of slide decks which can be re-used by community members as a basis for their presentations at events. For the time being, slide decks are based on the old 4:3 format, as this is still the most common, but in the future will also be available in the new 16:9 format. Needless to say, the file format is ODP, and fonts are those installed by LibreOffice.
Slide decks will be updated regularly, and the date will be featured on the wiki page (at the moment, the date is September 30, 2016 for all slide decks). If you plan to use a slide deck and you feel that some slides are outdated (or should be updated), please ask on LibreOffice marketing mailing list with the subject “Slide Decks” (marketing@global.libreoffice.org).
The gallery is available on TDF wiki at the following address: https://wiki.documentfoundation.org/Gallery_Presentations.
Berlin, September 29, 2016 – Just one day after the project 6th anniversary (https://blog.documentfoundation.org/blog/2016/09/28/happy-6th-birthday-libreoffice/), The Document Foundation (TDF) announces the availability of LibreOffice 5.2.2, the second minor release of the LibreOffice 5.2 family.
LibreOffice 5.2.2, targeted at technology enthusiasts, early adopters and power users, provides a number of fixes over the major release announced in August. For all other users and enterprise deployments, TDF suggests LibreOffice 5.1.5 “still”, with the backing of professional support by certified people (a list is available at: http://www.libreoffice.org/get-help/professional-support/).
A summary of the most significant new features of the LibreOffice 5.2 family is available on the website: http://www.libreoffice.org/discover/new-features/.
People interested in technical details about the release can access the change log here: https://wiki.documentfoundation.org/Releases/5.2.2/RC1 (fixed in RC1) and https://wiki.documentfoundation.org/Releases/5.2.2/RC2 (fixed in RC2).
Download LibreOffice
LibreOffice 5.2.2 is immediately available for download from the following link: http://www.libreoffice.org/download/libreoffice-fresh/.
LibreOffice users, free software advocates and community members can support The Document Foundation with a donation at http://donate.libreoffice.org.
Several companies sitting in TDF Advisory Board (http://www.documentfoundation.org/governance/advisory-board/) are providing either value added Long Term Supported versions of LibreOffice or consultancy services for migrations and trainings, based on best practices distilled by The Document Foundation.
OpenOffice.org Community announces The Document Foundation
The community of volunteers developing and promoting OpenOffice.org sets up an independent Foundation to drive the further growth of the project
The Internet, September 28, 2010 – The community of volunteers who develop and promote OpenOffice.org, the leading free office software, announce a major change in the project’s structure. After ten years’ successful growth with Sun Microsystems as founding and principal sponsor, the project launches an independent foundation called “The Document Foundation”, to fulfill the promise of independence written in the original charter.
The Foundation will be the cornerstone of a new ecosystem where individuals and organizations can contribute to and benefit from the availability of a truly free office suite. It will generate increased competition and choice for the benefit of customers and drive innovation in the office suite market. From now on, the OpenOffice.org community will be known as “The Document Foundation”.
[snip]
The Document Foundation is the result of a collective effort by leading independent members of the former OpenOffice.org community, including several project leads and key members of the Community Council. It will be led initially by a Steering Committee of developers and national language project managers. The Foundation aims to lower the barrier of adoption for both users and developers, to make LibreOffice the most accessible office suite ever.
The Foundation will coordinate and oversee the development of LibreOffice, which is available in beta version at the placeholder site: http://www.libreoffice.org. Developers are invited to join the project and contribute to the code in the new friendly and open environment, to shape the future of office productivity suites alongside contributors who translate, test, document, support, and promote the software.
Speaking for the group of volunteers, Sophie Gautier – a veteran of the community and the former maintainer of the French speaking language project – has declared: “We believe that the Foundation is a key step for the evolution of the free office suite, as it liberates the development of the code and the evolution of the project from the constraints represented by the commercial interests of a single company. Free software advocates around the world have the extraordinary opportunity of joining the group of founding members today, to write a completely new chapter in the history of FLOSS”.
Six years have gone by, and it seems like only yesterday. The Document Foundation has a stable governance, a growing team taking care of daily tasks and a community spanning over six continents (although there might be LibreOffice users in Antartica).
During this timeframe, the project has been able to attract new developers for 72 months in a row, quite an achievement for a source code which was said to be extremely difficult to contribute to (at least, when under the OpenOffice name). Last, but not least, LibreOffice has just won Infoworld’s Bossie (Best of Open Source) Awards for the sixth straight year in a row.
Starting from tomorrow, we will be focusing on the next major release – LibreOffice 5.3 – which will be launched at the end of January 2017, just before FOSDEM in Brussels. Stay tuned.
While most of our recent interviews have been focused on LibreOffice, this week we’re talking to someone involved in our sister project, the Document Liberation Project (DLP). If you’ve never heard of DLP before, watch our short video for an overview.
Alex Pantechovskis is a new contributor to the DLP, and has been working on libzmf, a library for importing Zoner Callisto/Draw documents.
Where are you based, what’s your IRC nickname, and GitHub profile?
I live in Lithuania, Vilnius. My IRC nick is AlexP11223, and my GitHub profile is at https://github.com/AlexP11223.
What prompted you to start work on libzmf?
It was a Google Summer of Code (GSoC) project. I thought that this project is interesting for me and the most suitable for my skills, so I contacted the mentor (David Tardon) via IRC and started working on it.
What was the biggest challenge working on the library?
ZMF4 is not the most complex file format (ZMF2 for example is much more complex, and this is one of the reasons why only ZMF4 is supported in libzmf so far), so working with it was not very difficult. But still there were some challenges, mostly related to reverse engineering: in binary formats it is often difficult to understand the exact structure of each element. Some small pieces such as vertical text align in tables are still not covered. Sometimes first attempts are found to be wrong as more details are uncovered, requiring rewrites of related code in the library.
Another challenge is: in some cases, when a feature doesn’t work as expected, it may be difficult or time-consuming to determine what causes this: wrong format understanding, wrong implementation, incorrect usage of librevenge and other libraries, bugs in libodfgen, bugs in LibreOffice…
What do you want to do next? (Either with libzmf or another library)
I don’t know – currently I am busy with studying at university, and some other things. It is possible that I will continue working on libzmf later, to add some of the missing features, or one of the other libraries.
What does the Document Liberation Project mean to you?
A great community doing important work.
How can others help to contribute to the DLP and open up proprietary files?
There are many ways to help. The most obvious is of course development: creating a new import library for some file format or improving one of the existing libraries or tools.
Also, most proprietary file formats do not have published specifications, so in order to work with them the structure needs to be reverse engineered and documented (preferably by contributing to OLE Toy project).
Another way, that does not require any programming skills, is creating and contributing sample documents for regression testing. It is an important but time-consuming task, because the documents should cover all format features (such as all parameters that can be set for a shape in a drawing application, or all text formatting options) and also many formats have more than one versions, so a separate set of documents is needed for each version.
What’s your favourite text editor and why?
For simple text, config files etc. I usually use whatever is available such as gEdit and Vim – on Windows I usually use Notepad++.
For coding I prefer IDEs like Visual Studio (C/C++, .NET) or JetBrains products (web development, Python, Java). I like the features offered by IDEs such as powerful refactoring, code completion, error/warning highlighting, convenient integrated debugging etc., and I have a powerful PC with SSD and a lot of RAM, so performance is usually not an issue. But I understand why many developers prefer editors like Vim (better text editing productivity, consistency, available everywhere), and it is especially relevant for big projects with complex build systems like LibreOffice, where it is hard/impossible to fully integrate (and maintain) an IDE.
During libzmf development I worked on Linux because it would be much more difficult to set up the needed environment on Windows (acquiring/building dependencies like Boost, librevenge, libtool, Autotools), so I used Qt Creator IDE. It allows developers to easily create a non-Qt C++ project from source files – and it worked fine most of the time.
Thanks Alex! And to anyone reading this who wants to get involved, join us and help to free the world from closed, proprietary file formats.
