Official scribus manual5/30/2023 Good writing is good writing, wherever you see it. It doesn't hurt to read about writing for writing's sake so that you can become a better editor of your own work and that of others. And you also have the challenge of keeping it lively as you get to hundreds of pages. This was one of the big chores that Christoph and I had with the official manual, trying to maintain a fairly consistent style throughout the book. You have a chance to-and should-develop your own style of writing. Along the way, you get feedback about whether what you're writing makes sense, whether it's concise, and hopefully that it's interesting to the reader. Good writing takes practice: In my case, the practice started out with trying to explain answers on the mail list, then creating more generic responses for the Wiki.Likewise, you will have the opportunity to report bugs or make suggestions for modifications or new features. You will need to interact with the developers, particularly when new features are added. Not only do you need to do your own work on this, but you need to listen to other users, especially those who are proficient with the software. Know your subject: You can't adequately write about software unless you know how to use it, and not just in some trivial way.Here are some key lessons that I would like to emphasize for those writing documentation: This has indeed been an amazing journey for me. Since then, using the manual as the inspiration, we continue work on revising and updating the online manual that comes with Scribus, so the work is never done with an actively developing project. (We considered that it would have been sacrilegious to use some other DTP software to create the Scribus manual.) The work was initially done in a special section of the Wiki, then exported to OpenOffice so that styles could be applied, then exported into Scribus for the final layout. The result, some nine months later, was Scribus, The Official Manual, a 400+ page manual written for the 1.3.3.x versions of Scribus. After I took an initial sophomoric stab at beginning one, Christoph Schäfer jumped in and helped organize a real effort to make something more organized and sensible. Much of the inspiration then and now comes from the mail list, either by starting a new page or bringing an old one up to date whenever we see that users are not able to find what they need.Īround 2008, we noticed recurring questions about whether there was documentation someone could hold in their hands-in other words, a real book. Just like most Wikis, the Scribus Wiki lets us write our own pages and edit and add to others' to improve the experience for users. For me, the Wiki became a test bed for practicing writing documentation, incorporating images to enhance the text, and most importantly, learning more about Scribus. At first the Wiki was created as an unofficial source of information, but with time it developed a reputation for having solid, practical information that users wanted. The result was to create a Wiki, set up for users to make documentation for other users. It seemed like we-already I was starting to feel a part of this project-could be making these expected questions and their answers available somewhere. With a mailing list's steady influx of new users, it's easy to see that the same or similar questions are asked over and over. Starting out, I asked quite a number of dumb or clueless questions, leading to more intelligent ones, and, after a time, I knew enough to answer other people's questions. When I began contributing to the project some 10 years ago, I had no knowledge about it at all, and consequently spent some time reading and interacting with the mail list to develop an understanding of how to use it. The project I have been involved with is Scribus, a desktop publishing (DTP) application used to create PDFs for publishing in print or web pages. I'd like to use my own personal journey with open source documentation to illustrate how it's possible to begin with little to nothing and create-and then build on-your work and that of others.
0 Comments
Leave a Reply. |