Re: [libreoffice-documentation] Video Tutorial Link in Help

2015-12-09 Thread Robinson Tryon
Sophie wrote:
>> What we do not want in localised version is content in en_US language.
>> Even if the sound is translated, UI still will be in English and it's
>> very difficult to focus on what you learn when all what you see is in
>> a foreign language.

In terms of the content that we provide on a per-language basis, I
agree that it's important to be able to provide consistency to those
users who desire it. For those who wish to see only content in
language XYZ, then we should strive to show them only content in XYZ.

On Wed, Dec 9, 2015 at 4:31 PM, Joel Madero <jmadero@gmail.com> wrote:
> Just for full transparency here. Sophie and I had an extended talk on
> chat and I'm of the belief that to prevent this from getting into help
> files because other locales aren't doing the same is not the smartest
> way to move forward. I instead would prefer including it and then
> supporting locales to do the same - in the respective languages, with
> the right GUI, etcThese then would be linked in the locales help
> files and it would empower the community, expand on the product, and
> give visibility to a great tool (videos that literally show exactly how
> to use features).

For those who are multilingual or just adventurous,  I can see the
potential benefit if users could choose on a program-wide level to
toggle on extra non-localized content (let's call it "Extended
Documentation") for each page of the Help. If we were to have rather
stringent rules about what content (format, length, structure,
license, etc..) could be included in this fashion, then we'd have a
decent roadmap on what content we'd like to see localized next.

If we're clever about how we include Extended Documentation, we could
even recruit for translation/localization by adding a small message to
any non-localized content such as "Want to see this content in
$CURRENT_LOCALE? Click here to help out!"

> I'd prefer discussing a better solution, one where we can agree that the
> tool is awesome for users, that the more visibility the better, and one
> that empowers contributors to follow Robert's lead and developer
> tutorial videos in their respective languages.

I'd suggest that any video content included or linked from the
Documentation be provided in a similar fashion to our existing text
content. Off the top of my head, this would include:
- Licensing under CC-BY or CC-BY-SA 3+
- Use of free/open file formats
- "Source" video archived safely somewhere in TDF infra
- Inclusion of extra source materials (e.g. talking points used to
make the video, example docs displayed or demonstrated during the
video, etc..) with the archived source video to help others who may
wish to edit or reshoot the content
- Ability to Download or view video using only Free Software (Archive.org?)
- Strong encouragement for any cross-platform content to be
demonstrated using the Doc Team's preferred Free Software GUI shell
[1]

It would be great to have subtitles provided for each source video
from the get-go, however that's definitely a task that can be handled
independently, freeing up video creators to create more videos...

Cheers,
--R

[1] 
https://wiki.documentfoundation.org/Documentation/Production#Sample_screenshots
Also see: https://en.wikipedia.org/wiki/Wikipedia:Software_screenshots

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org
802-379-9482 | IRC: colonelqubit on Freenode

-- 
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] [LibreOffice Bugzilla Migration] We're done! Please visit the new site to reset your password!

2015-01-24 Thread Robinson Tryon
Hi everyone!

The migration was a great success. All of our bugs are now happily living at

  https://bugs.documentfoundation.org/

Bugs should be referenced using the shorthand tdf#, such as tdf#12345.
On the wiki, you can write {{tdf|12345}} to link to a bug report.

Before you can log-in and start working on bugs, you'll need to reset
your password. Read more here:
https://wiki.documentfoundation.org/QA/Bugzilla/TDF_Bugzilla_Proposal/Migration_Userguide#After_the_Migration

If you have any questions or encounter any problems, please stop by
the QA IRC channel or drop us a note on the mailing list:
https://wiki.documentfoundation.org/QA/IRC
https://wiki.documentfoundation.org/QA/Mailing_List

A huge thanks to everyone who helped make this migration go quickly
and smoothly! Let's go tackle some open bugs!

Cheers,
--R

P.S. You'll start to see some updates and changes in Bugzilla over the
coming weeks. The QA Team is excited to work on improving, updating,
and polishing our bugtracker. We're always happen to have more people
join us!

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] [LibreOffice Bugzilla Migration] Starting shortly! Bugtracker will down for a few hours

2015-01-24 Thread Robinson Tryon
Hi all,

It's that time!  We're just about to migrate Bugzilla from
Freedesktop.org to TDF infrastructure.

For up-to-date information about the migration, join the
#libreoffice-qa IRC channel on Freenode and say hi!

For general information, see
https://wiki.documentfoundation.org/QA/Bugzilla/TDF_Bugzilla_Proposal/Migration_Userguide#Guide


KEY DETAILS:

- Migration Date: January 24th, 2015 at 15:00 UTC

- Migration Duration: Approximately 4-6 hours

- New URL: https://bugs.documentfoundation.org/


Once the migration is complete, I'll send out another email letting
you know you may once again ply us with myriad bug reports :-)

Cheers,
--R

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] Re: cover art for v4.4 user guides

2015-01-13 Thread Robinson Tryon
On Tue, Jan 13, 2015 at 9:19 AM, Tom Davies tomc...@gmail.com wrote:
 Hi :)
 I think Draw can handle Svg, or is it Eps?  Anyway it's one of the
 standard scalar vector graphics formats that Draw seems reasonably
 happy with.

https://wiki.documentfoundation.org/Media_Support/Summary

Draw can handle both SVG and EPS, but there are some caveats, and a
bunch of TODOs :-)

(I don't have test runs for images on Win and Mac yet, but I'm told
it's basically all internal libs, so should be about the same as on
GNU-Linux)

 Errr, actually i sometimes have a problem with images from Inkscape
 that involve text but that is not specific to Draw.  It seems to be
 more of a Windows problem afaik.

Sounds like a bug report ready to be filed!

Best,
--R

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] LibreOffice Bugzilla Migration is happening January 24th -- read on for more details!

2014-12-31 Thread Robinson Tryon
But first: Happy New Year, everyone!
https://colonelqubit.wordpress.com/2014/12/31/happy-new-year-libreoffice/


THE MIGRATION:

The QA Team and the wonderful admins over at Freedesktop.org have been
working hard to prepare for the migration of our LibreOffice bugs to
TDF infrastructure. I'm happy to announce that we'll begin the
migration on January 24th at 15:00 UTC.

For all kinds of details about the migration (as well as a whimsical
picture of our friendly walrus mascot in his Bugzilla-testing outfit),
point your browser here:
https://colonelqubit.wordpress.com/2014/12/31/mark-your-calendars-libreoffice-bugzilla-migration-is-1-month-away/


QUICK DETAILS:

- Migration Date: January 24th, 2015 at 15:00 UTC

- Migration Duration: Approximately 4-6 hours

- New URL: https://bugs.documentfoundation.org/

- Purpose: Migration will give us increased flexibility to extend
Bugzilla, integrate other TDF services, and provide granular support
for diverse tools including the Impress Remote and the Document
Liberation Project.

**Please Note**:
For your security, all passwords will be reset as a part of the
migration process. The first time you visit the site, click the
'Forgot Password' link and follow the instructions to set a new
password.

During the migration, Bugzilla will be *inaccessible*, but you may
join us in the #libreoffice-qa channel on Freenode or on the QA
Mailing List at any time during or after the migration for up-to-date
information about our progress. You can also just stop by to say hi!


MORE INFORMATION:

For more information, please see my blog post (above) and the
Migration Userguide:
https://wiki.documentfoundation.org/QA/Bugzilla/TDF_Bugzilla_Proposal/Migration_Userguide#Guide

If you have any questions about the migration, feel free to email me
or the QA mailing list:
https://wiki.documentfoundation.org/QA/Mailing_List


Cheers,
--R

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] Beta 1 of LO 4.4.0 is available

2014-11-22 Thread Robinson Tryon
On Sat, Nov 22, 2014 at 6:36 PM, Jean Weber jeanwe...@gmail.com wrote:
 The Beta1 can be installed alongside the stable version, so feel free
 to give it a try.

QA would be very happy for y'all to try out the Beta1! :-)

Instructions for installing multiple copies of LibreOffice are here:
https://wiki.documentfoundation.org/Installing_in_parallel

 Should you find bugs, please report them to the FreeDesktop Bugzilla:
 https://bugs.freedesktop.org

As it turns out, we're right in the middle of a Bug Hunting Session
for 4.4.0. Get more information on the wiki or just stop by the
#libreoffice-qa IRC channel and say hi!
https://wiki.documentfoundation.org/BugHunting_Session_4.4.0.0

Cheers,
--R

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] Which FAQs are unanswered?

2014-10-10 Thread Robinson Tryon
On Fri, Oct 10, 2014 at 12:58 PM, Steven Hupp swh...@gmail.com wrote:
 I want to start with the first entry-level hack of answering FAQs. I
 created an account on the wiki and found the FAQ page. However, it isn't
 clear to me which questions are unanswered. Is there a separate list? Thank
 you for your help.

Hi Steven,
If you're interested in answering questions, I'd also point out the
Ask LibreOffice site. It's more of a general questions-and-answers
site for our userbase than a traditional FAQ page, but it contains a
lot of information and can be a very useful resource :-)
http://ask.libreoffice.org/

Best,
--R

-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] Base documentation volunteers

2014-09-09 Thread Robinson Tryon
On Tue, Sep 9, 2014 at 11:53 AM, Alan Cook alanc...@gmail.com wrote:
 The reason that there's both a Guide and a Handbook is that the German
 documentation team got tired of waiting around for the English team to
 finish the Base Guide, so they took the draft chapters, translated them,
 finished the book, and published it as the Base-Handbuch. That document was
 then translated back into English as the Base Handbook.

Why the difference in name? Is the Handbook written in a different
style than our other guides?

 Contrary to what Tom D. indicated, the Handbook is /not/ shorter or less
 thorough than the Guide. Each is intended to be a complete and comprehensive
 user manual; the difference is that the Handbook is finished (although not
 up-to-date in English.) The current German version of the Handbook has 448
 pages in 11 chapters; the plan for the Guide includes 10 chapters, of which
 only 3 are complete.

Hmm... if they're roughly the same type of manual, then perhaps
name/content harmonization would help avoid confusion. (Apologies if
there's already been a conversation on this matter; please feel free
to point me at it)

...Moreover, this needs to be done by someone who's
 running Base on Linux. For reasons I don't understand, screen captures don't
 always work correctly when done using Windows, and Windows is what I'm
 running.

IIRC, most projects take screenshots in GNU/Linux for
1) Consistency
2) Avoiding any question about including screenshots of a proprietary WM


Best,
--R


-- 
Robinson Tryon
QA Engineer - The Document Foundation
LibreOffice Community Outreach Herald
qu...@libreoffice.org

-- 
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] Manuals in ePub format?

2014-04-22 Thread Robinson Tryon
On Mon, Apr 14, 2014 at 11:34 PM, Jean Weber jeanwe...@gmail.com wrote:
 Thanks for all your work on this. I'm glad you've kickstarted this
 topic again, and are following through so vigorously. I hope we can
 carry it through to some positive resolution this time, instead of
 having it fall by the wayside as has happened several times before.

Update time!

I've made a few more tests and changed some Tab-based layout to
table-based layout (which is much more HTML/EPUB-friendly). See the
tests referencing 'Boldt' (Harry Boldt is the developer of eLAIX)
here:
https://wiki.documentfoundation.org/EPUB/Converting_ODF_to_EPUB#Tools

On Mon, Apr 14, 2014 at 11:38 PM, PeeWee psaut...@libreoffice.org wrote:
 However, if the eLAIX people can develop something that improves format and 
 layout control, then I am willing to test it to see if it improves my 
 opinion. It could be worthwhile going into EPUB books so long as the 
 conversion is easy and does not take a great deal of time to prepare an EPUB 
 book for publishing.


Boldt is working on a new version of eLAIX that will hopefully address
even more of the little problems we've identified in the EPUB output.
I'll give another ping when that version is released, and perhaps
PeterS can take the lead here in evaluating what we might need to do
to our templates to make 1-click PDF and EPUB output possible.

Cheers,
--R

-- 
Robinson Tryon
LibreOffice Community Outreach Herald
Senior QA Bug Wrangler
The Document Foundation
qu...@libreoffice.org

-- 
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] Open Help Conference

2014-04-19 Thread Robinson Tryon
On Sat, Apr 19, 2014 at 7:38 AM, Shaun McCance sha...@gnome.org wrote:
 Hi all,

 I wanted to let you know that the Open Help Conference is happening
 again this year, June 14-15, in Cincinnati.

 http://openhelpconference.com/

 We've had some LibreOffice folks out before. It would be nice to see
 some of you again this year.

Hi Shaun,
Thanks for the ping -- the event sounds like a lot of fun! I'll be
busy that weekend, but perhaps there are a couple of LibreOffice
contributors from the area that will be able to make it.

(Doc Team:
1) If you plan to go, drop me an email so I can send you some I 3
LibreOffice stickers, etc..
2) Give us a report about the conference when it's all over! :-)
)

Cheers,
--R

-- 
Robinson Tryon
LibreOffice Community Outreach Herald
The Document Foundation
qu...@libreoffice.org

-- 
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] Manuals in ePub format?

2014-04-14 Thread Robinson Tryon
On Fri, Apr 11, 2014 at 10:58 PM, Robinson Tryon
bishop.robin...@gmail.com wrote:
 Given that we author the manuals in LibreOffice and use the same to
 generate PDFs, it would be easiest for initial set-up and maintenance
 to use the same tool to generate EPUBs. I'll chat with both the author
 of eLAIX and the Document Liberation team and see if either of them is
 interested in helping build/improve EPUB export specifically for our
 manuals.

Hi all,
As promised, I pinged both the DLP folks and eLAIX developer Harry
Boldt. The DLP has started on EPUB import, but no export work as of
yet:
https://wiki.documentfoundation.org/DLP/Libraries#epub

Boldt has been very helpful, providing me with a couple development
builds, making some improvements to eLAIX to better convert our
particular use cases, and sharing some hints about the best way for us
to format our ODTs to improve the resulting EPUB output.

I'll be posting some more examples of EPUB output on the wiki soon.
Your help in identifying output problems will be greatly appreciated.
My hope is that we can iterate on the extension and the
IntroducingLibreOffice.odt file at the same time until we reach a
result that we like, then update the rest of our ODT source files
using the same modifications.

Question: Where does the development version of the 'Introducing
LibreOffice' file live on ODF Authors?  (i.e. the master branch)
https://wiki.documentfoundation.org/File:GS4201-IntroducingLibreOffice.odt


Thanks,
--R

-- 
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] Re: Manuals in ePub format?

2014-04-11 Thread Robinson Tryon
On Fri, Apr 11, 2014 at 6:22 AM, PeeWee psaut...@libreoffice.org wrote:
 Another sample of an LO chapter in ePub format...
 This sample was created as a blank document in LO Writer and using standard
 style names where possible, for example Heading 1, Heading 2,Text Body, and
 so on. I did create a couple of styles to use for the note and tip that are
 in the sample. I then used to eLAIX toolbar in LO Writer when formatting the
 text and exporting to ePub format.

Neat!

I see that the hyperlinks in the ToC on the last page are clickable,
but those on page #2 are not. I had the same experience with the eLAIX
extension. Calibre's converter was able to turn those into proper
hyperlinks.

 There is a couple of points to note if we are going to use ePub format for
 our guides:

 1. The font will change to Times when exporting, but relevant font size and
 colour are kept.

Any particular reason for this one? I believe that one can embed
fonts, etc.. into EPUB docs.

 2. Any figures cannot be placed in LO frames, but have to be inserted
 without a frame to show after ePub conversion.
 3. You cannot use tables for Notes, Tips, or Cautions because you cannot
 control the width of the table when you export. This is why they appear a
 little different in the sample.
 4. What you see will depend on your display resolution and size. Also the
 size of the window when you open the sample in an ePub reader will affect
 how it looks. The ePub format is a flexible format that changes to suit when
 a reader opens a file.
 5. Any template for creating an ePub guide is going to have to be very
 simple so that it does run foul of the restricted formatting used when
 creating this type of document.

Some of these sound like direct limitations, but some might just be a
reflection on the current conversion process. When using Calibre to
transform ODT - EPUB, one can specify a separate CSS file. Perhaps we
can bridge some of these problems using similar, automated means.

Best,
--R

-- 
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] Manuals in ePub format?

2014-04-11 Thread Robinson Tryon
On Fri, Apr 11, 2014 at 5:22 PM, Jean Weber jeanwe...@gmail.com wrote:
 If possible, we should choose a solution that is free/libre open source
 software and runs on all three major platforms, so that any and all
 volunteers who wish to do this can use the same tool, without expense.

+1


 Of course, if that ideal is not a choice, then other solutions must be
 considered.

We do indeed have some non-free software in our tooling (e.g. Visual
Studio for Windows builds), but I agree that we should seek to avoid
or minimize it as much as we can, especially when the output files are
intended for all platforms.

 The other consideration is that the tool should be easy to use and require
 minimal (preferably no) manual intervention to prepare for the
 conversion* or clean up the results. This is for purely practical reasons:
 if much work is involved, it won't get done regularly for updated
 books, after the first flush of enthusiasm wears off.

I wholly agree here -- ideally we'd have a one-click script that would
take as an argument one or more ODT files and produce PDFs and EPUBs
out the other side.

 * Other than moving the source files (ODT) out of our current template
 and into a suitable template and using those new source files for
 generating PDF, ePub, whatever. That's a big job but should only need to be
 done once.

True. To be efficient, we should figure out our workflow before we
spend a lot of time modifying each source file.

Given that we author the manuals in LibreOffice and use the same to
generate PDFs, it would be easiest for initial set-up and maintenance
to use the same tool to generate EPUBs. I'll chat with both the author
of eLAIX and the Document Liberation team and see if either of them is
interested in helping build/improve EPUB export specifically for our
manuals.

Best,
--R

-- 
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] Re: Manuals in ePub format?

2014-04-09 Thread Robinson Tryon
On Wed, Apr 9, 2014 at 8:04 AM, PeeWee psaut...@libreoffice.org wrote:
 Hello

 If you follow the link there is an Test LO iBook in my Dropbox account.
 Unfortunately you will need iBooks Author to open the file. This is a free
 app you can download and if you are operating Mac OS. Sorry, but it is the
 only app I have at the moment that can do this kind of publishing.

 https://www.dropbox.com/s/t94v0kunqlpziqa/Test%20LO%20iBook.iba

Thanks for running a test!

 This is only a sample and is my idea of how an epub book should look.
 Definitely not finished. If you can view it, then you will notice that I
 followed the LO template fairly closely, but the template has to change.
 Note, Tips and Cautions are presently done as tables in the LO chapter
 template, which does create problems when going to epub format.

 Let me know what you think. I am now going to investigate a Linux app I can
 download to my Ubuntu virtual machine so that I can create a sample using
 ePub format.

Calibre (http://calibre-ebook.com/) is a FOSS, cross-platform
application that runs on Mac, Windows, and GNU/Linux. It might be a
good tool for us to prototype epub-compatible templates.

Best,
--R

-- 
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] Re: Manuals in ePub format?

2014-04-08 Thread Robinson Tryon
On Tue, Apr 8, 2014 at 3:01 AM, PeeWee psaut...@libreoffice.org wrote:
 Hello

 I agree with Jean about converting the guide files into ePub format about 
 getting a good-looking result.

I've run a few baseline tests using LibreOffice, Calibre, and a couple
of extensions that output EPUB. Results are here:
https://wiki.documentfoundation.org/EPUB#Converting_ODF_to_EPUB

Take a look at the end product and see what you think. I think we're
getting pretty close...

 I have tried a couple of times to convert a document file into an ePub format 
 and iBooks format. By their very nature, ePub formats have to be very 
 flexible to account for different resolutions and sizes of computer displays. 
 The biggest problem is the OO style names used in the files which takes away 
 this flexibility. If all the style names in the templates were converted into 
 the standardnames (Heading 1, Heading 2, and so on) used in other software 
 would help in the conversion process. I think the majority of conversion 
 programs expect standardised names for styles.

 Solution - convert a template to use standard styles, then try a conversion. 
 Any volunteers?

Sounds like a good idea. It would be great if someone could convert a
template to use standard styles and then re-run the tests on the wiki
page and see if that gives us better results.

Cheers,
--R

-- 
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] Manuals in ePub format?

2014-04-07 Thread Robinson Tryon
Hi guys,

I had a couple of people at SCALE and a handful of other people in the
past few months ask about ePub versions of our manuals. I'd run into
problems converting our ODTs - ePub in the past using Calibre, but I
just updated Calibre from the Ubuntu PPA and was successful at
converting the 'Introducing LibreOffice' document to ePub.

Would it be possible to adjust the workflow to export/upload an ePub
version of the manuals alongside the ODT and PDF versions on the wiki?
https://wiki.documentfoundation.org/Documentation/Publications

Calibre has a command-line interface that could make the conversion
process go quite quickly:
http://manual.calibre-ebook.com/cli/ebook-convert.html

Thanks,
--R

-- 
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] Manuals in ePub format?

2014-04-07 Thread Robinson Tryon
On Tue, Apr 8, 2014 at 12:48 AM, toki toki.kant...@gmail.com wrote:
 On April 7, 2014 8:54:09 PM PDT, Robinson Tryon  wrote:
version of the manuals alongside the ODT and PDF versions on the wiki?
https://wiki.documentfoundation.org/Documentation/Publications

 Wouldn't it be simpler to use the export to ePub extension option for LibO, 
 than use Calibre?

It certainly could be -- which extension? eLAIX?

--R

-- 
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] US/Canada folks: Document Freedom Day meetup in NH on March 29th

2014-03-22 Thread Robinson Tryon
Hiya,

Tom suggested that the Documentarians might be interested in what's
going on with Document Freedom Day :-)

For anyone not in the US, events are planned all over the world. See here:
https://wiki.documentfoundation.org/Events/2014/Document_Freedom_Day
https://documentfreedom.org/events/events.en.html

--

Interested in open standards and FOSS?

LibreOffice will be hosting a lunch meetup at noon on Saturday, March
29th at Ramunto's in Hanover, NH. We'll be celebrating Document
Freedom Day (DFD) and talking about what we can do to encourage the
use of open formats by local government and schools.

For more details, please see the event page here:
https://wiki.documentfoundation.org/Events/2014/Document_Freedom_Day/USA/New_Hampshire

RSVP appreciated (so I can plan numbers accordingly :-)

Cheers,
--R

-- 
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] LinuxQuestion.org Members Choice Awards -48hrs left to vote

2014-02-03 Thread Robinson Tryon
On Mon, Feb 3, 2014 at 9:06 AM, Marc Paré m...@marcpare.com wrote:
 If you are using Linux and wish to participate, there are only 48hrs left to
 vote for the Members Choice Awards for 2013 ... especially the Office Suite
 Award.

 You need to register to vote! Feel free to join in on the vote and let your
 voice be heard!

 Links:

 Office Suite voting page:
 http://www.linuxquestions.org/questions/2013-linuxquestions-org-members-choice-awards-109/office-suite-of-the-year-4175488208/page3.html

 All categories voting page:
 http://www.linuxquestions.org/questions/2013-linuxquestions-org-members-choice-awards-109/

Hi Marc,
I thought I had an LQ account, but didn't find my credentials, so I
re-registered. I've tried to follow the steps to make it possible to
respond to the poll (e.g. creating my first post to the
introduce-yourself forum), but I'm still blocked. I just wanted to let
other people know that if they can't access the poll, it might not be
their fault! :-)

Best,
--R

-- 
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] LinuxQuestion.org Members Choice Awards -48hrs left to vote

2014-02-03 Thread Robinson Tryon
On Mon, Feb 3, 2014 at 12:20 PM, Robinson Tryon
bishop.robin...@gmail.com wrote:
 I thought I had an LQ account, but didn't find my credentials, so I
 re-registered. I've tried to follow the steps to make it possible to
 respond to the poll (e.g. creating my first post to the
 introduce-yourself forum), but I'm still blocked. I just wanted to let
 other people know that if they can't access the poll, it might not be
 their fault! :-)

Of course, immediately after I post about my woes, the poll opens up
to me!  I guess it's possible that there's also a time-delay rule of
15-20 minutes for new accounts.

Cheers,
--R

-- 
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] Changes to front cover and copyright notice required for user guides to go on Amazon

2014-01-29 Thread Robinson Tryon
On Mon, Jan 27, 2014 at 7:03 AM, Andrew Douglas Pitonyak
and...@pitonyak.org wrote:
 On 01/26/2014 07:15 AM, Robinson Tryon wrote:

 Couple of points: 1) I don't believe the LibreOffice Documentation Team
 is a legal entity, so I'm not sure that it can hold copyright (at least not
 in the US). 2) In general, I believe TDF/LibreOffice does not request
 copyright assignment, so copyright in contributions to code, wiki pages,
 documentation, etc.. is all held by the individual contributors, or the
 company/organization for which they work, if it is a work-for-hire. Here's
 the text we use in the 'About' box in LibreOffice: This release was
 supplied by The Document Foundation. Copyright (c) 2000 - 2014 LibreOffice
 contributors. Thanks, --R


 If you choose to be pedantic, I expect that LibreOffice contributors is
 also not a legal entity,

true

 but it is probably closer to the truth as to who
 owns the copyright :-)

When I read the info box, I see LibreOffice contributors as a group
of people, not a single/formal entity (e.g. LibreOffice
Contributors), similar to the Open Document Format vs. an open
document format.

 I also do not know how important it is that the front cover and meta-data
 directly reference a legal entity, especially if the truth of the matter is
 that the individual contributors hold the copyright for their own
 contributions.

Good point. I think it would be fine to put something like
LibreOffice Documentation Team, et al. on the front cover (with a
longer explanation inside), but because copyright is held by
individuals, an explicit implication of copyright such as (c) 2014
LibreOffice Documentation Team or (c) 2014 TDF seems misleading.

Best,
--R

-- 
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] Changes to front cover and copyright notice required for user guides to go on Amazon

2014-01-27 Thread Robinson Tryon
On Mon, Jan 27, 2014 at 1:54 AM, Marina Latini mar...@studiostorti.com wrote:
 +1 Robinson. I think that the LibreOffice Documentation Team isn't a legal 
 entity.

 So, what about:

 This document is Copyright © 2014 by The Document Foundation.
 You may distribute or modify it under the terms of either the GNU General 
 Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or 
 the Creative Commons Attribution License 
 (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.


Hi Marina,
Thanks for the suggestion!

I'm still pretty sure that TDF doesn't hold copyright to these guides
(and if they do, perhaps only to a small portion of the overall
contributions), so implying that these works are solely copyright
TDF would not meet our licensing obligations.

Best,
--R

-- 
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] Changes to front cover and copyright notice required for user guides to go on Amazon

2014-01-26 Thread Robinson Tryon
On Sat, Jan 25, 2014 at 3:28 PM, Jean Weber jeanwe...@gmail.com wrote:
 For distribution through Amazon etc, the front cover of the book must
 include the name of the author of the book, and that name must match
 the name given in the copyright statement and in the metadata we
 provide to Lulu.

Ok

 I have been listing LibreOffice Documentation Team as the author in
 the metadata, and I propose to change the copyright statement in each
 book to read:

 This document is Copyright © 2014 by the LibreOffice Documentation
 Team. Contributors are listed below. You may distribute or modify it
 under the terms of either the GNU General Public License
 (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the
 Creative Commons Attribution License
 (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.

Couple of points:

1) I don't believe the LibreOffice Documentation Team is a legal
entity, so I'm not sure that it can hold copyright (at least not in
the US).

2) In general, I believe TDF/LibreOffice does not request copyright
assignment, so copyright in contributions to code, wiki pages,
documentation, etc.. is all held by the individual contributors, or
the company/organization for which they work, if it is a
work-for-hire.

Here's the text we use in the 'About' box in LibreOffice:

  This release was supplied by The Document Foundation.
   Copyright (c) 2000 - 2014 LibreOffice contributors.


Thanks,
--R

-- 
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] Copy documentation from OpenOffice.org?

2013-12-02 Thread Robinson Tryon
On Mon, Dec 2, 2013 at 6:12 AM, C smau...@gmail.com wrote:

 Screenshots are considered to be derivative works under US Copyright
 Law (refer to the US Copyright Act of 1976, Section 101 if you want
 details). There is nothing wrong with including screenshots (as part
 of your documentation) of an application running under Windows, OSX,
 or any other operating system.

IANAL, but Wikipedia has some interesting notes about software screenshots:
https://en.wikipedia.org/wiki/Wikipedia:Software_screenshots

In particular, they prefer taking screenshots on FOSS operating
systems -- even mentioning us :-)

In the case of multi-platform programs that are FOSS, and have a
visibly similar interface between platforms (such as LibreOffice or
GIMP for example), it is preferred that screenshots be taken under a
FOSS operating system (such as a Linux distribution).

The also note: Please ensure that the demonstration content itself is
self-made, freely licensed or in the public domain to prevent the
accidental inclusion of non-free content, pointing out that
[s]creenshots depicting FOSS on Windows or OS X (or any other
commercial operating system) pose the potential for issues with
screenshots because they are non-free;

They go on to say that while consensus in their project has been that
Windows Classic and Win8 Metro themes are too basic for copyright
protection, the OSX interface elements and Aero Glass theme may be
sufficiently original for protection.

As many of you know, Wikipedia licenses their content under the same
CC-BY-SA 3.0 Unported license that we use for most of our content*, so
their analysis may be quite applicable to our situation.

Cheers,
--R

* IIRC some of our older docs might be under a different license...

-- 
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] I'm not a spammer!

2013-11-30 Thread Robinson Tryon
On Sat, Nov 30, 2013 at 10:46 AM, Glen Reesor g...@jenniferandglen.ca wrote:
 Hello Robinson / Cloph

 Just wondering if there's any progress on this. Since sending this email
 I've been able to make only one change on the wiki. The rest of the time I
 get throttled.

Hi Glen,
I'm unable to repro the edit throttling right now (I made a number of
edits to a number of pages), but because of the weird nature of the
buggy-filters, I totally believe that it's happening to you :-)

Cloph - Any further thoughts on what we can do here?

Thanks,
--R

-- 
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] Copy documentation from OpenOffice.org?

2013-11-29 Thread Robinson Tryon
On Fri, Nov 29, 2013 at 6:54 AM, Tom Davies tomdavie...@yahoo.co.uk wrote:
 Hi :)
 If we did copy the worst case scenario is apparently that we get
 served with a Cease and Desist or a Take down notice
 ...
 Plus the chance of being caught out is very small...
 ..
 If we don't copy and DO the translations ourselves and the result is
 much the same as the Apache one then wouldn't that be considered a
 copy anyway?
 ...so, i think that in this case it is worth taking the risk because the
 chance of it being a problem is fairly tiny and it's very easy to fix
 if there is a problem.

(IANAL either)

I think we should be careful about basing our policy on a quick cost
vs. benefit risk analysis. If a licensing question arises in the
course of our work, I propose that we try to resolve the particulars
first and then copy code/documentation/media after we've gotten our
ducks in a solid row.

On Fri, Nov 29, 2013 at 4:45 PM, C smau...@gmail.com wrote:
 Unless otherwise stated, the FAQ pages on the OOo Wiki are under the
 PDL ( http://www.openoffice.org/licenses/PDL.html ). The PDL license
 wasn't added to every FAQ page for various reasons that made marginal
 sense at the time.

Clayton -- Is there a way that the correct license could be added to
those webpages and/or a note could be put somewhere online on the
openoffice.org website that confirms the licensing?  It would just
make the whole process of verifying licenses before copying content
much cleaner.

FWIW, I'm not sure that the PDL is compatible with CC-BY-SA 3.0 (the
license of the TDF Wiki):
https://creativecommons.org/compatiblelicenses
https://wiki.documentfoundation.org/User:Qubit/license

Thanks,
--R

-- 
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] Copy documentation from OpenOffice.org?

2013-11-28 Thread Robinson Tryon
On Thu, Nov 28, 2013 at 10:20 PM, Glen Reesor g...@jenniferandglen.ca wrote:
 I'm working on translating the Math FAQ from French to English and noticed 
 that very good English versions of these questions exist 
 athttps://wiki.openoffice.org/wiki/Documentation/FAQ/Formula
 div
 Given that LibreOffice forked fromOpenOffice.orgin 2010 (prior to the vast 
 majority of content on thatOo.orgpage), is the licensing such that we can 
 just copy these FAQs to the LibreOffice FAQs?
 - Glen

The OOo wiki to which you linked states that Content is available
under . [sic] (they appear to have an issues correctly rendering the
copyright/license for the page). Looking at the page source, it
appears the intended target is Wiki:Copyrights[1]. The Wiki:Copyrights
page says the following:

---
Portions of the OpenOffice.org Wiki are Copyright 1999, 2010 by
contributing authors and Oracle and/or its affiliates.

Sections or single pages of this wiki are covered by certain licenses.
If a license notice is displayed at a given wiki page, you may use the
content of that page according to that license.

In all other cases, the page is licensed under the Apache License,
Version 2.0 (ALv2).

In posting a new contribution, you are licensing that contribution
under the Apache License, Version 2.0 (ALv2).
---

May one combine ALv2 works with CC-BY-SA v3.0 works (under the latter
license) ? I'm not certain, but (to pick one of many possible points
of incompatibility) I believe that the various patent provisions in
ALv2 are not (sufficiently) expressed/protected by CC-BY-SA.

tl;dr - One may not copy entire FAQs from wiki.openoffice.org -
wiki.documentfoundation.org (IMHO)

Cheers,
--R

[1] https://wiki.openoffice.org/wiki/OpenOffice.org_Wiki:Copyrights

-- 
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] I'm not a spammer!

2013-11-27 Thread Robinson Tryon
On Wed, Nov 27, 2013 at 1:54 PM, Glen Reesor g...@jenniferandglen.ca wrote:
 Hello Robinson,
 I'm also getting throttled as an anti-spam measure. However I haven't made
 any other changes today (or yesterday). I'm trying to create the Math link
 at
 https://wiki.documentfoundation.org/Faq

Hi Glen,
I'm able to make at least one change to the wiki with my account right
now, but the problem is (I believe) a cumulative effect.

Cc'ing Cloph here for advice.

Thanks,
--R

-- 
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] I'm not a spammer!

2013-11-21 Thread Robinson Tryon
On Thu, Nov 21, 2013 at 11:30 AM, Robinson Tryon
bishop.robin...@gmail.com wrote:
 We've been running into some problems with the wiki lately, and I've
 been working with cloph to try to remedy them asap.
 ...
 I'll ping back to the Docs list once I have more information for you.

Cloph has disabled some of the offending code. Please let us know if
you're still experiencing problems editing the wiki.

Thanks,
--R

-- 
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] I'm not a spammer!

2013-11-21 Thread Robinson Tryon
On Thu, Nov 21, 2013 at 11:19 AM, Hazel Russman
hazeldeb...@googlemail.com wrote:
 I decided to spend this afternoon doing some intensive editing of the
 Calc wiki. After about two hours, the site throttled me and refused to
 accept another page as an anti-spam measure. It said to try again in
 a few minutes but I just got the same result so I logged off.

 In future I shall do only one or two articles a day.

Hi Hazel (et al),

We've been running into some problems with the wiki lately, and I've
been working with cloph to try to remedy them asap. Having had my
edits throttled has been very annoying, so I know exactly how you
feel!

I'll ping back to the Docs list once I have more information for you.

Thanks,
--R

-- 
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] Upcoming Bugzilla Migration

2013-11-17 Thread Robinson Tryon
Hullo Documentarians!

As some of you already know, QA is migrating the project's bugtracking
activities to a separate instance of Bugzilla:
https://wiki.documentfoundation.org/QA/Bugzilla/LibreOffice_Bugzilla_Proposal

All user accounts, data, etc... will be transfered-over, and we expect
that our users won't notice a thing, aside from the name and url
change.

In preparation, I'm working on updating all of our internal docs and
resources to point to the new domain 'bugs.libreoffice.org', and
replace references to 'FDO' and 'Freedesktop.org Bugzilla' with more
generic 'Bugzilla' or 'LibreOffice Bugzilla' references. The domain
bugs.libreoffice.org has been pointed at bugs.freedesktop.org,
allowing us to change references today and then have a transparent
switch-over on the day of migration.

I'm not sure how many FDO references we have in our documentation, but
I'd appreciate it if the Docs Team could update these references or
point me in the right direction to make these updates myself.

Thanks,
--R

-- 
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] Upcoming Bugzilla Migration

2013-11-17 Thread Robinson Tryon
On Sun, Nov 17, 2013 at 2:45 PM, Jean Weber jeanwe...@gmail.com wrote:
 Offhand I can't think of any mentions in the user guides, but I'll
 check.

Great!

 I'm sure there are some mentions on the Docs wiki somewhere, or

Based on a quick search, I found (and fixed) just a single reference
to bugs.freedesktop.org under the Documentation/ pages on the wiki.

 in resources like the Contributors Guide. I'll check the latter, and
 hopefully others can track down any mentions on the wiki -- or might
 recall or be able to find any mentions in other user docs.

Sounds like a plan.

Cheers,
--R

-- 
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] Wikihelp/Help Wiki/Online Help/etc... needs one clear name

2013-11-12 Thread Robinson Tryon
Hiya,

I've been doing some prep work for our upcoming Bugzilla migration and
I've noticed that we have a few different names for the same online
help/wiki resource, and that's confusing. I suggest that we pick one
name and standardize on it everywhere.

Here are a sampling of some of the names and examples of their use:

= Wikhelp/WIKIHELP

This one is used on the wiki and in the bugtracker:
https://wiki.documentfoundation.org/Development/Wikihelp
https://wiki.documentfoundation.org/QA/Bugzilla/Components/Documentation/Extended_Help

= Wiki Help

This one is in the Template:Menu on the wiki:
https://wiki.documentfoundation.org/Template:Menu

= The Help Wiki

Mentioned in the blurb for the 'Documentation' component in Bugzilla:
https://bugs.freedesktop.org/enter_bug.cgi?product=LibreOfficebug_status=UNCONFIRMEDcomponent=Documentation

= Online Help

This name is given on the wiki, alongside Wikihelp:
https://wiki.documentfoundation.org/Website/Web_Sites_services

= LibreOffice Help

The menu option in LibreOffice itself (Help - LibreOffice Help).

---

One of the issues with the term 'wiki' is that it's very generic. We
have our regular wiki at wiki.documentfoundation.org, but we don't
call it the TDF wiki or the LibreOffice Wiki, we just call it the
wiki, which makes the term Wikihelp slightly more ambiguous,
especially for newcomers to the project.

Some people might think the name Wikihelp refers to help for our
wiki. Some might guess from the name that it's a generally-editable
wiki. But neither are true.

The term Online Help avoids the term wiki, but I feel like it
could be a bit more descriptive. A couple of ideas off the top of my
head:
* Online Help Pages
* Online Reference

Because we use the same content to generate the local help, it would
behoove us to choose a name that conveys that connection, e.g.

  Online Help Pages - Local Help Pages

We want users to instantly recognize that what they're looking at
online is related to what they have available inside LibreOffice (and
vice-versa). We could further emphasize that connection by
differentiating the names in logos/etc:

  ONLINE Help Pages - LOCAL Help Pages

In LibreOffice itself, the menu option could be LibreOffice Help Pages.

Thoughts?

Cheers,
--R

-- 
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] White Paper

2013-10-29 Thread Robinson Tryon
On Tue, Oct 29, 2013 at 4:03 PM, dbclinton dbc...@gmail.com wrote:
 Hi,
 I've completed a draft of my white paper making the business case for LO
 over MS Office.
 For now, for want of a better solution, I've branded it as part of the
 LibreOffice Document Foundation and put it in its own folder on the ODF site
 here:
 http://www.odfauthors.org/libreoffice/english/white_papers/transition-from-ms-office-to-libreoffice-white-paper
 For those who can't access it there, you can download a PDF here:
 http://www.marbitz.com/portfolio/LO_White_Paper.pdf
 I'm interested in any and all comments, corrections and thoughts as to how
 it could be put to good use.

Thanks for working on this whitepaper! I'll try to take a look at it
later tonight.

 Perhaps someone might also cross-post this
 email to market...@global.libreoffice.org

(CC'd)

 I've tried a couple of times to
 join up only to be steadfastly ignored (my email mysteriously disappears
 down the Internet's terrifying, gaping maw).

Ah, sorry to hear that. If you're still having troubles, feel free to
ping me off-list and I'll help you get your subscription squared-away.

Cheers,
--R

-- 
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] Re: Filling the EN FAQ

2013-05-11 Thread Robinson Tryon
On Sat, May 11, 2013 at 3:40 AM, Tom Davies tomdavie...@yahoo.co.uk wrote:
 Hi :)
 It's also been given as a link directly when people ask questions about Base 
 as it's been about the only viable documentation about it.


Good to know -- we often get people with Base-related questions on the
Ask site and I'm often not sure where to point them!

That definitely reinforces my thought that some of the items currently
in the Faq could serve as a great set of examples in the Base
documentation. Is this something that others would support? Alex -- If
you like the idea, would you consider authoring some of the changes?

Cheers,
--R

-- 
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] Looking to Get Involved

2013-03-08 Thread Robinson Tryon
On Fri, Mar 8, 2013 at 1:00 PM, Jean Weber jeanwe...@gmail.com wrote:
 On Fri, Mar 8, 2013 at 9:20 AM, Hazel Russman
 hazeldeb...@googlemail.com wrote:
 How is the Base Handbook getting along? I could perhaps do another
 chapter of this or have a look at the French FAQ.

 Please do another chapter of the Base Handbook, from Chapter 7
 onwards. The next item on my list to do was finishing the chapters
 that have already been translated and looking for people to translate
 the others.

+1

We've gotten a number of questions on the LibreOffice Ask site from
people who are hungry to learn more about how to use Base, so
additional/updated Base documentation would be greatly appreciated!

--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] IRC Channel?

2013-02-21 Thread Robinson Tryon
On Thu, Feb 21, 2013 at 3:45 PM, Kieran Peckett crazyske...@gmail.com wrote:
 Is there an IRC channel on freenode for the Documentation team? The only
 mention of IRC on the Get Involved/Documenters page at the website is to do
 with the #documentfoundation channel, which is just for general TDF stuff. I
 know QA have one, and I wondered if there was one for Documentation as well.

 Admittedly I see no obvious reason for one, as the responses here seem to be
 pretty prompt. However, if there is one I would at least like to know what
 it is.

I've gotten a few nibbles by hanging out in the following unofficial channels:
#libreoffice-doc
#libreoffice-ask
#libreoffice-design

Cheers,
--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] De-geeking BugReport on Wiki

2013-02-16 Thread Robinson Tryon
On Sat, Feb 16, 2013 at 1:22 AM, Tom Davies tomdavie...@yahoo.co.uk wrote:
 Hi :)
 I like the changes.  Actually i prefer
 someone to bug-triager
 and
 person to developer

 While the more precise definitions are important to us and we might 
 'naturally' understand what the terms ,eam those things might not be so 
 obvious to a noob.  In photography a developer is a liquid and bug-triager 
 could be a bot or anything.  It could even mean that crazy loony from CSI: 
 Vegas.  I think the important thing for a noob to know is that when they post 
 a bug-report the very next actions that happen to the report will be done by 
 a person, a human being, not a machine ior automated process.  Beyond that is 
 just confusing detail that they don't really need to know at such an early 
 stage.


 Perhaps some hierarchy tree or flow-chart might help the user understand the 
 process that happens after filing the bug-report but again i think it's too 
 much information and so it risks confusing the poor wide-eyed-end-user.


As Tom notes above, when we write or update documentation, we need to
think about our audience. It's really important that we think about
the most exposed pieces of our internal docs and make sure that they
are comprehensible to outsiders.

For example, here's a chunk of the current text on that page:

---
If you are not sure what component your problem is about, choose the
Libreoffice component. Someone will come and change it later. For more
information about this, have a look at [[BugTriage]]. If it is an
urgent issue (broken parts, regression, etc), experienced users can
assign it to one of the developers listed on the [[FindTheExpert]]
page.
---

All of the information in the above paragraph is useful to someone,
and that's why it's there. Unfortunately, even though someone
(probably a Bug Triager) needs to know that information, most users
don't. That's why it would be good for us to have a much simpler page
targeted at users that provides the minimum amount of information they
need to submit a bug report.

At the top of that simple page, we could provide a big link that
points experienced users and volunteers to the Advanced Bug Report
Page. That split should make it easier for us to keep detailed
documentation in one place, and have very simple, derivative
documentation for our regular users.

In addition to making our docs as simple as possible, we need to make
bug submission as simple as possible. The BSA is a good start, but
there's a lot more we could do to simplify bug submission for ordinary
users. (But that's probably a topic for a different thread :-)

Cheers,
--R

P.S. Here's a quick thought: Would it be possible for us to put a very
light background tint on the wiki pages? We could color all of the
pages reviewed to contain content suitable for beginners with pale
green, and use other colors for particular content or technical level.
Default of white, of course. This could serve as a helpful clue for
users who are clicking around our site.

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] De-geeking BugReport on Wiki

2013-02-16 Thread Robinson Tryon
On Sat, Feb 16, 2013 at 3:18 PM, Tom Davies tomdavie...@yahoo.co.uk wrote:
 Hi :)
 wrt coloured backgrounds a pale yellow often helps some people with
 dyslexia.  So, i kinda like the simplicity of green for users, amber for
 more technical pages or internal pages such as minutes of meetings and then
 perhaps white writing on red for devs but i think it could easily get really
 bad visually.

Fair enough. I was largely suggesting the background color to make it
easy for beginners to determine what content was written at their
level. Using some kind of header image or big icon in the sidebar
could work similarly.

 Actually i like Sophie's point about the Documentation Team being
 responsible for wiki's in the documentation section and other teams being in
 charge of their's.  If we did go that route then everything aimed at normal
 users could be in the documentation section, preferably as sub-sub-sub-pages
 off the Published page.
 Unfortunately that would mean moving a lot of pages.

Hmm... are you suggesting that the Documentation Team would handle all
of the pages for beginners? Providing a consistent tone and authoring
style across all of the beginner pages could be beneficial, but could
give them a lot more work, especially in terms of keeping the beginner
docs up to date with information from upstream teams.

--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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: Liaison across 'lists', was: Fw: [libreoffice-documentation] Re: Questions galore!

2013-02-15 Thread Robinson Tryon
On Fri, Feb 15, 2013 at 10:24 AM, Sophie Gautier
gautier.sop...@gmail.com wrote:
 On 15/02/2013 13:47, Charles-H. Schulz wrote:
 Tom

 We have a liaison list since the beginning, it's the projects@ list.
 We had it since the beginning.

 Yes this list serves for cross communication between NL projects,
 developers and all the projects who need to communicate about their work
 (ESC minutes are posted on it for example).

Oh, interesting! I didn't know that such a list existed...

I took a glance at the mailing list page, but didn't find a mention of
'projects' or the 'projects list':
https://www.libreoffice.org/get-help/mailing-lists/

Is the projects mailing list something we'd like to add to that page?

Thanks,
--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Good figures showing the power of LibreOffice

2013-02-12 Thread Robinson Tryon
On Tue, Feb 12, 2013 at 7:43 AM, C. H. D. LibreOffice Docs
webofht-libofficedoc...@yahoo.com.hk wrote:
 Hello! Documentation Team!

 I recently downloaded some files to test whether they would open in 
 LibreOffice 4.

Neat!

 When I downloaded 400 .doc files, I opened 399 files in LibreOffice.

 Only 1 could not be opened.

Hmm. So close to a perfect score!

 All 400 files were smaller than or equal to 692.5 KB. I started the testing 
 from the smallest file to the largest file. It happened to be that I could 
 not open that one file which was 692.5 KB.


C.H.D. -- Thank you for your testing. It's great for us to have some
quantitative testing from time to time! I must admit -- now I'm rather
curious about what's special about that last file!

Would it be possible for you to file a bug[1] and include that file as
an attachment? If there's anything sensitive in the file, you could
either redact it or I could give you the email address of one of our
senior QA folks so that the file wouldn't need to be made public.

Cheers,
-- Robinson 'qubit' Tryon

[1] https://www.libreoffice.org/get-help/bug/

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Version 4.0 - Enjoying it?

2013-02-12 Thread Robinson Tryon
On Tue, Feb 12, 2013 at 2:27 PM, John Robertson j...@flippers.com wrote:

 I am unhappy that 4.0 doesn't seem to support OSX - saw a note that NONE of
 the developers have an OSX machine. Tried 4.0 (beta), found many issues (for
 OSX users) and went back to 3.6

 I hope I am wrong, but for now this is my position: disappointed.

 John :-#(#

Hi John,

Sorry to hear that you've had some problems with the 4.0 release. We
don't have that many developers who work on Macs, but we do support
their work as best we are able. We also have some Mac users active in
Documentation (as Jean pointed out), in QA, and in our other teams.
Would you be willing to help us identify some of those bugs so our
developers could try to fix them for you?

The user support list is probably the best place to get some guidance
on reporting the issues that you're facing:
http://www.libreoffice.org/get-help/mailing-lists/

If you have more general questions about how to use certain features
on OSX, please feel free to use the Ask site here:
http://ask.libreoffice.org

You can also take a look at this bug and see if any of the bugs you're
experiencing have already been reported:
https://bugs.freedesktop.org/show_bug.cgi?id=42082

Thank you for your assistance in improving LibreOffice for the Mac. We
really appreciate it!

Cheers,
-- Robinson 'qubit' Tryon

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Request: Update help file/docs to reflect current capabilities of Calc re: charts on separate sheets

2013-02-11 Thread Robinson Tryon
http://ask.libreoffice.org/en/question/11775/how-can-i-put-a-chart-on-a-separate-sheet-in-calc/

From the user:
I know that the help file specifically states that charts cannot be
on their own sheet.

As pointed out in the Answers, the functionality does currently exist,
we just need to make sure that's clear in the documentation. Please
feel free to use the A's to this Q in any new docs.

I've also asked the user to file an enhancement request for the put
on separate sheet functionality he's familiar with from Excel. I
don't know if/when it's appropriate to put an enhancement bug# in the
documentation, but I'm happy to pass that information along when I
receive it.

Thanks,
--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Re: Questions galore!

2013-02-11 Thread Robinson Tryon
On Sun, Feb 10, 2013 at 1:05 AM, Marc Paré m...@marcpare.com wrote:

 When I first went to the odfauthors.org site, I thought that it was a
 site for end-users because of the highly-prominent links to books for
 sale, but now I believe that the website is largely focused on
 internal production. Perhaps there's something we can do to make
 things more clear to regular users as well as to our volunteer
 community.


 ODFAuthors have been partners with OOo and in particular with LibreOffice
 from the very start.

cool.

 Jean Hollis Weber of ODFAuthors is one of our most
 prolific contributors on the project, we also make use of ODFAuthor
 resources and goodwill. I believe it is we who should be thankful for
 ODFAuthors helping us out with the docs teams and resources. I doubt things
 would go as smoothly without Jean and her team at ODFAuthors who work at
 quite high professional standards.

Yes, I'd previously run across the Taming LibreOffice website, but
didn't put the pieces together until just recently that she was the
head of the Documentation Team :-)

 As far as I can remember, all that same information is already up on the Ask
 site. You just have to find it. No need to go to Archive.org.

ok, cool.

 IMO, most questions users ask on the Ask.LibreOffice.org site are
 probably
 best answered there, and, IMO, I don't see a reason to work on any
 user-related FAQ when the Ask.LibreOffice.org site is probably the best
 type
 of solution for a good living/breathing FAQ site.


 Using the Ask site as the general FAQ as we go forward sounds like a
 solid plan to me. The FAQ on the wiki currently has some overlap with
 the Ask site:  https://wiki.documentfoundation.org/Faq

 What do you guys think about migrating questions from that FAQ to the
 Ask site? I'd be happy to shepherd that work, if that's amenable to
 you.


 I don't think this would be an acceptable option as the FAQ is, again, used
 in large part for contributor work.

Ah, okay. Most of the questions on the FAQ on the wiki seem to relate
more to *use* of LibreOffice than being a *contributor* to the
project. The contributor-specific content I see on that page is a link
to the List of Frequently Asked Questions for Development.

These types of questions/categories seem like they're more suited to a
user-targeted FAQ:

 - Spell-checking doesn't work !
 - What are the system requirements for LibreOffice? 
 - How do I change the email client used by LibreOffice? 

 IMO, there is nothing wrong with
 overlapping/doubling or information as people tend to operate in different
 ways; some like to get information from FAQ's, others from Ask sites, others
 from mailing lists, others from forums ... IMO, it is up to the site
 maintainers to triage the information appropriately so that it is factual
 (as best as one can get) for their own particular user base. To me, it
 doesn't sound like a good idea to remove a contributor tool for users when
 we are in need of contributors.

I think doubling could be okay if we had enough manpower to maintain
all of our web properties. As you mention, we are in need of
contributors, and every additional copy of documentation or
information requires additional personnel to keep it fresh and up to
date.

To wit, some of the entries in the wiki FAQ are merely pointers to
other pages (e.g. the System Requirements) and seem unlikely to
change. However there are other pages, such as the information about
supported file formats, or information about the user profile, that
may need more frequent updates:
https://wiki.documentfoundation.org/Faq/General/012
https://wiki.documentfoundation.org/Faq/General/110 (redirects to
https://wiki.documentfoundation.org/Documentation/UserProfile)
Also see https://wiki.documentfoundation.org/UserProfile

I believe that since 3.6, LO has dropped support for export in some
StarOffice file formats, and I believe that the user profile for LO4
is stored under .config/libreoffice/4/, but we haven't had a chance to
update that information yet.

The Ask site is mostly reactive, rather than proactive, so while we do
have updated info about the StarOffice formats:
http://ask.libreoffice.org/en/question/1839/i-have-some-old-star-office-writer-files-extension/

...we don't have up to date information about the User Profiles:
http://ask.libreoffice.org/en/question/5899/user-profile/
http://ask.libreoffice.org/en/question/903/where-are-the-libreoffice-data-profile-files/
http://ask.libreoffice.org/en/question/4628/how-to-reset-user-profile-on-mac-osx-108-mountain/

The Ask site contributors seem to be basing their information on
what's on the wiki, so perhaps we should put a stronger emphasis on
keeping the information on the wiki up to date. I know that's a really
big task, but it's definitely worth some thought.

   - When answering a Q, there should be a clear/easy way to ask the Doc
 Team where to find the latest documentation on a particular topic

   - If How do I do X? comes up and we don't have 

Re: [libreoffice-documentation] Re: Questions galore!

2013-02-11 Thread Robinson Tryon
On Sun, Feb 10, 2013 at 1:43 PM, Jean Weber jeanwe...@gmail.com wrote:
 Although the wiki pages themselves are CC-BY-SA, most of the user
 guide chapters use CC-BY 3.0 (not CC-BY-SA) due to their historical
 origin as OOo guides. I have never heard of any of the contributors to
 those chapters objecting to incorporating material from them into
 other documents licensed under CC-BY-SA.

Ah, interesting. So if I understand correctly, the wiki, main site,
blog, ask site, forum, extensions, templates, etc... are all
standardized on CC-BY-SA 3.0. The user guides are (mostly) CC-BY 3.0,
so the guides may be mixed-in to the content of the CC-BY-SA sites,
however the help wiki is LGPLv3, so it's only directly compatible with
the code of LibreOffice.

Does the help wiki need to be LGPLv3 because of the way it's combined
with what we ship?

--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Re: Request: Update help file/docs to reflect current capabilities of Calc re: charts on separate sheets

2013-02-11 Thread Robinson Tryon
On Mon, Feb 11, 2013 at 8:24 PM, Robinson Tryon
bishop.robin...@gmail.com wrote:
 http://ask.libreoffice.org/en/question/11775/how-can-i-put-a-chart-on-a-separate-sheet-in-calc/


I've filed this as https://bugs.freedesktop.org/show_bug.cgi?id=60711

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Re: Questions galore!

2013-02-10 Thread Robinson Tryon
On Sun, Feb 10, 2013 at 12:20 AM, Marc Paré m...@marcpare.com wrote:
 The specific case here has been dealt with, so I consider that issue
 resolved. In the more general case, I guess the question is When
 linking to content, what documentation resources will be least
 susceptible to link rot?

 --R


 Well, realistically, all of them. Our work is based on the numbers of
 contributors, and, like any other part of the project, we cannot force
 anyone to work on anything that they do not want to work on. So, IMO, unless
 there are very committed people on board, then, all work on the project is
 susceptible to link rot.

When I say link rot, I'm specifically referring to the issue of
content remaining accessible over time via a particular URL:
https://en.wikipedia.org/wiki/Link_rot

I understand that LibreOffice needs someone to keep the servers
running, however unless there's an issue with our software, floeff
alone could probably keep all of the pages on the wiki, the Ask site,
etc... up and running (as static content) for the next decade. If
we're going to link Answers on the ask site to content outside of the
Ask site, we'd like those links to remain accessible for as long as
possible.

To ask a slightly different question: Is there any plan within LO to
remove hosted content or to further change urls for hosted content?

Thanks,
--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Re: Questions galore!

2013-02-09 Thread Robinson Tryon
Apologies for not responding sooner -- I've been spending my spare
moments since Thursday dealing with questions and bugs relating to
4.0.

On Thu, Feb 7, 2013 at 10:46 AM, Marc Paré m...@marcpare.com wrote:

 The FAQ section was indeed changed to the About Us section after a
 discussion on the marketing list that I initiated. The rationale behind this
 is/was that the FAQ was not being used for LibreOffice specific questions
 and had been set up in 2010 prior to Ask.LibreOffice.org. The Ask site was
 put together in order to provide users with a more organized zone for such
 information as well as to replace the FAQ.


 Before moving the FAQ, I looked for, and found, the answers to all questions
 on the FAQ's that related to question regarding problem fixing with
 LibreOffice on the Ask.LibreOffice.org site. These FAQ items were then
 purged from the FAQ and the FAQ was moved to the About Us section.


Okay, so to summarize, the FAQ was slimmed-down, purged of questions
regarding problem-fixing, and moved under the About Us section.
Gotcha.

 As well, the larger questions then remaining on the FAQ related to the
 TDF/LibreOffice project. Thus, the About Us section was decided as the most
 appropriate section of the site to post it. So, the FAQ on the About Us
 section is not a general LibreOffice FAQ section for trouble shooting, but
 an FAQ with regards to historical questions relating to the
 community/project

Ah okay. This FAQ has a historical component to it.

 and of information relating to Licensing question, which
 we must publish as per LGPL rules.

I don't believe that we have any obligations under the LGPL to
distribute anything other than the code (or content) + the LGPL
license. It's beneficial for us to have a Licensing FAQ, but I don't
think it's something we must have.

 BTW, the FAQ may even be cut back even
 further once I we update the site a bit more. IMO, that particular FAQ will
 not appear in its present state for long, this, of course depending on our
 (marketing or website or ...) prioritized to-do lists.

Fair enough. The FAQ is rather small, so it might be easiest to
consolidate the questions and answers to a single page.

 * We have 3+ FAQs and the Ask site -- what can we do to reduce
 repetition?  (DRY)

 I have gone to all three FAQ's and have found no duplication of information.
 In fact all three FAQ's are quite specific to their particular area which is
 where I would assume a user/members would go to first look/find an answer to
 their question. But, reasonably speaking, our sites are quite large, and
 even I get lost with the amount of information available on the pages
 (especially the wiki).

Yes, that's definitely something that happens to me :-)

When I first went to the odfauthors.org site, I thought that it was a
site for end-users because of the highly-prominent links to books for
sale, but now I believe that the website is largely focused on
internal production. Perhaps there's something we can do to make
things more clear to regular users as well as to our volunteer
community.

 I am sorry if the Get Help FAQ move caused this headache. Let me know if
 there has been a loss of some important information and I will make
 arrangements to post it back onto the Ask.LibreOffice.org site for future
 reference.

Thanks. Is all of the content on that site available under a license
compatible with that of the Ask site? (CC-BY-SA 3.0) If so, I can just
copy-in anything I need from the cached copy up on Archive.org.

 As for the duplication of the FAQ of information and the Ask.LibreOffice.org
 site as well as of updating/syncing this information -- no, no such
 discussions have occurred. Be aware, that from time to time these FAQ may be
 rationalized depending on their various team's decisions, also be aware that
 the product of the FAQ information on the wiki pages are not from user
 questions BUT more from the contributing members organizing of the
 information/materials ... so, sometime, the information is more relative to
 the contributing member and not a regular user.

Okay, cool. I was just curious to see how much conversation was going on :-)

 HOWEVER, the bottom line is that we are here to help our users with
 questions and to provide them with the best answers we can possibly offer.

I definitely agree!

 IMO, most questions users ask on the Ask.LibreOffice.org site are probably
 best answered there, and, IMO, I don't see a reason to work on any
 user-related FAQ when the Ask.LibreOffice.org site is probably the best type
 of solution for a good living/breathing FAQ site.

Using the Ask site as the general FAQ as we go forward sounds like a
solid plan to me. The FAQ on the wiki currently has some overlap with
the Ask site:
https://wiki.documentfoundation.org/Faq

What do you guys think about migrating questions from that FAQ to the
Ask site? I'd be happy to shepherd that work, if that's amenable to
you.

 My question to you now is this; have the mods/admins 

Re: [libreoffice-documentation] Questions galore!

2013-02-09 Thread Robinson Tryon
On Thu, Feb 7, 2013 at 1:38 PM, Jean Weber jeanwe...@gmail.com wrote:
 * What's the status of documentation for LO 4.0?

 We're doing it as fast as we can (very small team of active members),
 starting with the Getting Started guide.
 ...
 When we can is the only answer to schedules and estimated dates. Did
 I mention what a small active team we have? ;-)


Or as Daniel Webster might have said, It is a small team, and yet
there are those who love it! :-)

Given the size of your workforce, is there anything that the rest of
the volunteers on the project can do to help get the 4.0 documentation
out? Maybe a documentation sprint ? :-)

If there's any work that could be chunked-up, like proofreading or
feature-confirmation, that might be a good way to offload some of the
tasks. It also looks like contributors need a separate log-in for the
odfauthors.org website -- I should reinvestigate SSO and see if that
could further-reduce hurdles to inter-group participation in the LO
community.

Thanks,
--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Questions galore!

2013-02-09 Thread Robinson Tryon
On Thu, Feb 7, 2013 at 2:09 PM, Tom Davies tomdavie...@yahoo.co.uk wrote:
 Hi :)

Hi!

 Bear in mind that there are only around 4ish documenters to cover the work
 of 500 devs.  Also MS Office only has 1 branch every 4 years (ish) whereas
 LibreOffice has 2 per year.

I've heard the same story from the QA team: A few (determined) hands
for bucket-loads of bugs. It sounds like we should do some recruiting!
:-)

Who is in charge of the LibreOffice volunteers? Is there anyone who
wears a hat like Volunteer Coordinator ?

--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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] Re: Questions galore!

2013-02-09 Thread Robinson Tryon
On Thu, Feb 7, 2013 at 9:04 PM, Marc Paré m...@marcpare.com wrote:
  IMO, it would be
 better to find the instances of the links and remove them. There could not
 be that many as surely, the Ask.LibreOffice.org site would have either
 escalated that particular answer with the link to the top of the best
 answers list or the java description would have been spelled out in one of
 the answers and escalated to the top.

The specific case here has been dealt with, so I consider that issue
resolved. In the more general case, I guess the question is When
linking to content, what documentation resources will be least
susceptible to link rot?

--R

-- 
Unsubscribe instructions: E-mail to documentation+h...@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