Re: [libreoffice-documentation] simplifying documentation
Dave, Here is a suggestion that might help those of us who are new: a chart or listing that attempts to show who is involved in the documentation team and what they are doing. It might be hard to ensure that everyone is included but perhaps it could start with the people who have been actively participating in the mailing list. There is little hierarchy but some people have higher levels of formal responsibility and it would be good to know who they are. If possible, it would be interesting to know people's geographical locations as well. A chart or listing for the overall LibreOffice structure would also be helpful. It need not be very detailed but could give a sense of how it is organized and maybe who some of the main players are. It should be possible to produce these without significant effort. Or better still, they already exist and just need to be linked to. Cheers, Cathy On 7/29/2017 4:06 AM, Dave wrote: On the (US English) download page, inside the box for the chosen version it reads: LibreOffice 5.4.0 release notes Supplementary Downloads: Help for offline use: English (US) (Torrent, Info) need another language? The installer file for the off-line/local help facility, is offered as "Supplementary" (additional) to the main installation file, because it is a convenience option, not an essential requirement to use the software. If the off-line help is not installed the software automatically attempts to provide the on-line equivalent in the user's web browser. If you have a suggestion for the "simple fix" rewording to convey this in a few words, we can put it forward to the website team. "Few words", because everything has to be translated into many (https://www.libreoffice.org/community/nlc/) languages, by our (overworked) translation volunteers. Oliver was not suggesting the wiki is not a good source of information. The wiki content has been built up over a number of years and in some areas it would benefit from a bit of housekeeping. As with all things in open source software, there is always much more work to be done than there are hands to do it. You seem to be looking for some kind of single reference source that will inform people about everything within the complex structure of this fairly large project. Can you give some indication as to what level of detail and what audience(s) such a source should cater for. Maybe something suitable could be drafted and put forward as an overview for the "Get Involved" page: https://www.libreoffice.org/community/get-involved/ You might have misinterpreted Sophie's post. Pootle is not exclusively related to the online version of the software, it is a tool/facility/service used by the translators for many aspects of the software. On 29.07.2017 02:14, Cathy Crumbley wrote: Thanks for your input. These is much to learn! I am referring to the LibreOffice download page. Why? Because it sounds like I am not the only one who is unaware that we need to download a separate file for the Help files. It should be a relatively simple fix to just re-word what is on that page so that people understand. It is puzzling that this has not been done since people are aware of the problem. I can see what is on the wiki. However, Olivier said "But it requires permanent reordering and addition/deletion/update of hundreds of pages, permanently." I was trying to understand if he was saying that it is not a great source of information. In any case, it sounds like it is the only place to get an overview of LibreOffice (although it is still challenging to do so). From your description of Pootle, I was able to learn that an online version of LibreOffice is in the works. I don't really understand the rest of it, but at least I now know that Pootle is related to that project. On 7/28/2017 4:41 AM, Sophie wrote: Hi Cathy, Le 27/07/2017 à 21:55, Cathy Crumbley a écrit : Hi Olivier, Thanks again for the responses. If this has been a problem for a while, I am puzzled about why it has not been fixed. Are you aware of a reason why the download page cannot be re-worded now? It depends on which download page you're talking about. The download page on the main website is reworked by infrastructure, design and marketing project, together with the donate page. It's currently being improved before being translated. For the download page of the documentation project, the page is quite new, and maybe no volunteer had time to work on it for the moment. To be clear, what are you saying is the best source of information for people who are new to this and want to learn about the overall LibreOffice project? Are you saying that the wiki is not useful because so much work needs to be done on it? On the wiki, you'll see the different sub-projects of the LibreOffice overall project, mainly: development, QA (quality assurance), UX/Design (user experience), l10n (localization), documentation, infrastructure, marketing, certification and NLPs (native language project
Re: [libreoffice-documentation] simplifying documentation
There have been several posts about this issue but I am still not clear how to suggest changes to the user interface. Exactly what should I do? On 7/29/2017 5:46 AM, Olivier Hallot wrote: Hello Cathy needsUXEval is a buzzword for "Need User Experience Team evaluation". We have a group of people specialized in software user interface design that evaluates all aspects of the human interaction with the software. Em 28/07/2017 23:27, Cathy Crumbley escreveu: I appreciate your advice about how to get the wording revised on the program download page. Unfortunately, I don't know what adding "needsUXEval to the keywords field" means. Could you please translate into plain English? -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] Draft GS6.0 Chapter 1 Draft
I've uploaded GS6001 - Introducing_LibreOffice_PF_20170804.odt to the Authors website: https://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-6.0/chapter-1-getting-started-6-0-pf/view and updated the wiki accordingly. In this draft I: - Added a line or two about the keyboard shortcuts in context menus and how to disable/enable them. Included a screenshot that may or may not be necessary, if not, it will be deleted. - Added a section to the end of the chapter titled "Troubleshooting LibreOffice in Safe Mode. Screenshots at the moment are placeholders. After all changes have been merged into a single document, I think, for consistency, a single person doing a review/edit of the merged document should contribute the screenshots so that visual consistency is maintained. -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Uploading changes
On 04.08.2017 06:48, Paul Figueiredo wrote: > When uploading my edits to the ODF Authors site, do I upload a new version > with my changes separately so that there are multiple Chapter 1 drafts that > are later collated and merged? Or do we have a single Chapter 1 file that > is being replaced as new people edit and upload? > > Thanks in advance Hi Paul, We each upload our individual drafts of the chapters. To identify whose draft it is, the file name is laid out as guide name and chapter, followed by initials and date. For example my draft has been uploaded with the file name GS6001-Introducing_LibreOffice_DCB_20170803.odt so yours might be GS6001-Introducing_LibreOffice_PF_20170804.odt. When each member of the current team has completed their part of a chapter the individual submissions can be pulled together in a single file and reviewed as a complete chapter. In the past one author has worked on the entire chapter of a guide (draft or review) and then uploaded it for further review/revision by another author. That process has worked reasonably well in terms of guide accuracy, but has to some degree slowed down the guide production speed. With the GS Guide for 6.0 we are trying/testing a different approach in an attempt to find out if there are alternative methods that work for all of us, without placing an excessive burden on any one author. What we are trying here might seem to be a bit piecemeal, but we need to find a way of speeding up guide production to keep better pace with the software's development and meet the needs of our users. It occurs to me that some members of the team might not be familiar with wiki editing and may find it confusing as to how/where to add their entries to the "Status of tasks" on https://wiki.documentfoundation.org/Documentation/Development/User_Guide_Tasks#Status_of_tasks_-_GS_-_LO_v6.0 page. If you, or any member of the team, would find it helpful, I am willing to scratch together a mini-tutorial about this, just let me know. Best Regards Dave -- Please address any reply to the mailing list only. Any messages sent to this noreply@ address are automatically deleted from the server and will never be read. -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted