More Documentation online

Documentation General
#1

Hi :slight_smile:
The North American community produce a LibreOffice Dvd which includes
documentation but they are having trouble keeping up.

Could we automate it so that when something gets uploaded to the wiki we either
1. notify Tim & Drew perhaps by email
or
2. upload the doc to their website (mirror??)
or
3. show the date that each document was last uploaded to the wiki?

Those are the 3 options i could think of. There might be a better way of doing
this. Drew is desperately busy organising an event this weekend & Tim's answers
tend to be even more verbose than mine!
Regards from
Tom :slight_smile:

#2

As the person who usually uploads new and changed user guide chapters and
books to the wiki, I am happy to email Tim and Drew at the time. I don't
know a way to automate this.

I agree about putting a date by the files on the wiki. In fact, I was
thinking about this just yesterday. I've been doing that for the OOo files
for years. I'll fix up the page within the next few days, if I don't forget.

Jean

Hi :slight_smile:
The North American community produce a LibreOffice Dvd which includes
documentation but they are having trouble keeping up.

Could we automate it so that when something gets uploaded to the wiki we

either

1. notify Tim & Drew perhaps by email
or
2. upload the doc to their website (mirror??)
or
3. show the date that each document was last uploaded to the wiki?

Those are the 3 options i could think of. There might be a better way of

doing

this. Drew is desperately busy organising an event this weekend & Tim's

answers

tend to be even more verbose than mine!
Regards from
Tom :slight_smile:

From: Tim Lungstrom <timothy@lungstrom.com>
To: Tom Davies <tomdavies04@yahoo.co.uk>
Sent: Thu, 28 July, 2011 18:02:23
Subject: Re: More Documentation online

Well, the CMS server should have that option to create a DVD with the
documents on it.

<snip />

Are you stating that once the document comes out - like one of the

Writer's

guides, they will update it from time to time? I am not on the
documentation lists, but I do want to make sure all my copies are the

most

up-to-date. Should I just download them every few months, of is there

a way

I can be notified when the updates are available?

Hi :slight_smile:
Would it be easier in the future to just link to the existing

pages

and perhaps mirror the documentation?
http://wiki.documentfoundation.org/Documentation
http://www.libreoffice.org/get-help/documentation/
The documentation is likely to get updated quite a bit and added

to.

Having them separately stored on separate sites means

fragmentation is

going to be a big problem later.

<snip />

Regards from
Tom :slight_smile:

________________________________
From: Drew Jensen

To: Tim Lungstrom <timothy@lungstrom.com>
Cc:
Sent: Thu, 28 July, 2011 2:04:23
Subject: Re: More Documentation online

I just found that LibreOffice Math Guide is out.

Now the only issue I have is that OOo used "0800" for the

preface

number, but LibreOffice uses "0700".

So maybe we can add the Math Guide to the NA documentation

list.

This guide is 26 pages.

Already on it - I moved all of the Calc guide to the site

today and

pulled the Math guide down also, just haven't updated the html

page

yet.

//drew

--
Unsubscribe instructions: E-mail to

documentation+help@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

#3

Hi :slight_smile:
I am quite happy to put the dates on the wiki initially. I'm open to
suggestions if people don't like the way i first do it. There are a lot of easy
options on how to do it so i will start with the easiest but it's easy for me to
develop that :wink:
Regards from
Tom :slight_smile:

#4

I am delighted to defer to you on that chore, Tom!

--Jean

#5

Hi Jean,

As the person who usually uploads new and changed user guide chapters
and books to the wiki, I am happy to email Tim and Drew at the time.
I don't know a way to automate this.

Do you upload changed chapters via the Wiki upload function?

Then anybody interested could just watch the File page, they should get
informed by e-mail when a new version is uploaded. At least in theory,
this should be tested before, of course :wink:

Which chapter will be uploaded next?

Nino

#6

Hi Nino
How to "watch the page"? Do you mean subscribe or something like that so they
get emailed when a change occurs? I might make my adjustments first and then
suggest that as i'm not exactly sophisticated when editing a wiki and usually
notice problems just after hitting "confirm" (or whatever).

Regards from
Tom :slight_smile:

#7

Hi Nino
How to "watch the page"? Do you mean subscribe or something like
that so they get emailed when a change occurs?

Exactly. Registered and email-confirmed users can choose in their
preferences to get email notified on page changes.

I might make my
adjustments first and then suggest that as i'm not exactly
sophisticated when editing a wiki and usually notice problems just
after hitting "confirm" (or whatever).

You just have to check "E-mail me when a page on my watchlist is
changend" in the User profile tab of the preferences.

Nino

#8

Yes, I use the wiki upload function.
The chapters of the Impress Guide and/or the Draw Guide will be the next to be uploaded, sometime in the next week I hope.
I don't know when any changed (updated) chapters will be ready for upload.

Tom, please note that Nino is talking about the upload pages for individual files, not the page that lists those files for users to download. Watching for changes to the list page (such as changes to dates listed for files) certainly will be a good indicator that some linked file may have changed, but won't be as definitive as watching the actual file upload pages. I can give a better example later, and it might be a good tip to put into the Contributors' Guide.

Jean

#9

0700 was used for the OOo Migration Guide for OOo 1.x and maybe 2.x, but it was never updated and probably never will be. When I moved the guides over to LibreOffice, I did not leave that number unused, but instead changed the Math Guide's number to use it.

--Jean

#10

Hi Jean,

Yes, I use the wiki upload function.
The chapters of the Impress Guide and/or the Draw Guide will be the
next to be uploaded, sometime in the next week I hope. I don't know
when any changed (updated) chapters will be ready for upload.

So we could test it then.

Tom, please note that Nino is talking about the upload pages for
individual files, not the page that lists those files for users to
download.

Indeed - but not very conveniant as a lot of pages have to be watched.

A different (and probably better) idea is to use Alfresco for this
purpose. I did not have a look at Alfresco yet but I'm pretty sure it
can be tweaked to email-notify people when a new document is put into
"published" state or an existing one is updated.

Watching for changes to the list page (such as changes to
dates listed for files) certainly will be a good indicator that some
linked file may have changed, but won't be as definitive as watching
the actual file upload pages. I can give a better example later, and
it might be a good tip to put into the Contributors' Guide.

(In the OOo Wiki Clayton had installed an extension allowing to watch a
whole category of pages. Maybe this could ease life in TDF wiki, too, as
only one page would have to be watched.
So if not possible to tweak Alfresco, we should definitively ask the
wiki admins to install the CategoryWatch extension.)

Nino

#11

Hi,

So if not possible to tweak Alfresco, we should definitively ask the
wiki admins to install the CategoryWatch extension.)

There are indeed add-ons for Alfresco to work with Mediawiki, but I'm
not sure if that directly includes the kind of page watch
functionality you're talking about. It will most certainly be quicker
for the wiki admins to install the category watch extension you
mention.

Slightly OT: BTW, I'm busy at work on http://media.libreoffice.org,
which would become the public-facing, no-login viewer and download
point for the material being worked-on with Alfresco. Ultimately,
there could be means of tracking new stuff on various other of the
project's web resources, including the wiki.

Impressum (Legal Info) | Datenschutzerklärung (Privacy Policy)   Content on this site is licensed under a Creative Commons Attribution Share Alike 3.0 license.