Category: Documentation

Today we’re talking to Rafael Lima, who helps the LibreOffice project by updating its documentation…

To start with, tell us a bit about yourself!

I am a university professor in Brazil, and I teach and research optimization applied to management sciences. In my work I often need to write papers and prepare spreadsheets to analyze data, and for that I’ve been using LibreOffice for over a year now. I have been working with supply chain optimization problems such as vehicle routing, network design and facility location.

I have always been an enthusiast of Open Source, since my undergraduate days in 2001. At the time I started using Linux and most of my current research work is done using FOSS tools. The dynamics of how open source software is developed is a topic that has always caught my attention.

Outside of work, I like to spend my free time practicing sports (mostly playing tennis) and whenever I have the opportunity I like to travel to new places. And obviously, like many tech enthusiasts, I like gaming too!

What are you working on in the documentation project right now?

The Documentation Team is currently working on the guides for the LibreOffice 7 series, and I am helping update and review some chapters in these guides. I have recently updated the Getting Started Guide chapters on Math and Macros.

Besides that, I have recently started writing a Macro tutorial focused on LibreOffice Calc, to help Calc users to get started with Basic programming and develop their own macros and functions. I hope to cover many aspects of Basic programming in Calc, ranging from reading and writing data from cells, formatting, dialog creation and writing extensions. If all goes well, I hope to finish the tutorial by February and release it to the community. If anyone wants to follow the development of the tutorial, it is available on my GitHub page.

How did you get started in the LibreOffice community? What was the experience like?

I started contributing to the Documentation Team after I read a blog post by TDF saying that they were looking for volunteers to help update the guides for LibreOffice 7. Then I joined the mailing list and I was welcomed and instructed by Olivier Hallot on the workflow of the Documentation Team.

After going over the Wiki and the Contributor’s Guide, I started updating the Math Guide. It was a very nice experience, because all questions I had were promptly answered by other members of the team and I was able to learn quickly how work gets done.

After finishing the Math guide I kept on contributing with other guides, mainly the Getting Started Guide and the Writer’s Guide.

Anything you’d recommend to newcomers in the docs project?

My work in the Documentation Team was my first real experience with an open source project, and it was a great opportunity to learn how open source really works. It’s amazing to see how the LibreOffice community is capable of delivering high-quality applications and documentation.

As a newcomer I was afraid I was not going to be able to tackle the complexities of such a huge project as LibreOffice. However, being a large project means that LibreOffice has a large community to support new contributors.

From a more practical standpoint, my recommendation for newcomers is to start by reading the Contributor’s Guide, and then choose one of the LibreOffice applications to which you would like to contribute. Also, join the mailing list, introduce yourself and more experienced members will be glad to explain how contributions can be made.

Many thanks to Rafael for all his contributions! And for everyone reading this who wants to build up skills for a potential career in technical writing, join our community, gain experience, and meet new people!

LibreOffice has extensive documentation in many languages, thanks to the great work of our worldwide docs community. Today we’re talking to Steve Fanning, who has been working on the updated LibreOffice Calc Guide…

Hi Steve! Tell us a bit about yourself…

I live near Bolton in the North West of England with my wife and, sometimes, our adult son (he has recently been working in Australia for a year). I studied applied mathematics and theoretical physics at university and subsequently enjoyed a career mostly spent implementing and designing complex real-time software systems.

Passionate about improving the documentation for the company’s systems, I moved into specialist technical writer roles during the last few years of my employment. I retired around two years ago and now enjoy indulging in my main hobbies, which are bridge, computing, reading and coarse fishing. I guess that some readers might wonder about coarse fishing – it is angling for freshwater fish for pleasure and relaxation rather than food (all fish caught are returned to the water alive).

What are you doing in the LibreOffice project?

On retirement, I wanted to maintain and develop my technical writing skills and after some research, decided to join the LibreOffice Documentation Team. I immediately dived into the deep end, updating some of the more challenging chapters of the Calc Guide in preparation for the 6.2 issue. Since then I seem to have been digging deeper into Calc, coordinating the publication of the 6.4 Calc Guide, and updating many of the chapters for the 7.0 Calc Guide. I have also enjoyed creating an area on The Document Foundation’s wiki to describe Calc’s 500+ functions in more detail.

Why did you decide to become a member of The Document Foundation, the non-profit entity behind LibreOffice?

When the opportunity arose, I was delighted to become a member of TDF. I am hoping that it will make me more aware of the strategies of the organisation and, if appropriate, provide greater opportunity to influence those strategies. And who could resist the offer of a free @libreoffice.org email address?

What else are you working on, and is there any other area that interests you?

Currently most of my LibreOffice time is taken up supporting and mentoring Ronnie Gandhi, who is a technical writer helping us under the Google Season of Docs 2020 programme. His task is to populate many of the pages within the Calc Functions wiki area and I am reviewing his work and providing comments and other feedback as appropriate. Many of these functions are quite complex and require some research before raising comments but I am finding the whole experience very educational.

As for the future, it is hard to look too far ahead as we are all enduring the COVID-19 pandemic and the resulting restrictions and lockdowns. With lots of free time on my hands, I have been grateful to have interesting LibreOffice work to occupy myself and keep my brain ticking over. In the future I hope to continue to help keep our guides up to date, continue developing the Calc Functions wiki area, and would also like to get more involved in maintaining the help system.

Many thanks to Steve for all his work, and mentoring other contributors – this all helps millions of LibreOffice users around the world! Indeed, joining the documentation project is a great way to contribute back to LibreOffice, build up skills and meet new people in the community. Join in and give us a hand!