On Mon, Dec 3, 2012 at 3:04 PM, janI <j...@apache.org> wrote:
> When we change FAQ (and I really like the idea of using MDTEXT), we should
> make it easy to translate for all the local sites, and not only the first
> time, but more importantly to stay up to date with the translation.
>
> Do we currently have any tools to "watch" a mdtext file, so when the
> english version is changed the local translators are notified ? If not we
> should think of a mechanism, since especially FAQ are of interest in all
> languages.
>

On Windows there is this CommitMonitor tool:
http://tools.tortoisesvn.net/CommitMonitor.html

Also, you can "roll your own" with email filters on messages sent to
the commit list.

-Rob

> Jan I.
>
>
> On 3 December 2012 20:54, Keith N. McKenna <keith.mcke...@comcast.net>wrote:
>
>> Rob Weir wrote:
>>
>>> On Sun, Dec 2, 2012 at 1:41 PM, Andrea Pescetti <pesce...@apache.org>
>>> wrote:
>>>
>>>> On 26/11/2012 Rob Weir wrote:
>>>>
>>>>>
>>>>> [Can I install Openoffice on my IPAD?] I nominate this for an FAQ.
>>>>>
>>>>
>>>>
>>>> I agree. But where is our FAQ page currently? Unfortunately, there's an
>>>> "OpenOffice FAQ" easily reachable by search engines at
>>>> http://www.openoffice.org/faq.**html<http://www.openoffice.org/faq.html>and
>>>>  quite outdated (I don't know whether
>>>> it's reachable from the home page, but it doesn't seem so).
>>>>
>>>> Time to make a new FAQ available or update the old one and link to it
>>>> from
>>>> the current site?
>>>>
>>>>
>>> The current location of the FAQ is prominent in search results.  That
>>> is valuable and worth preserving.
>>>
>>> But the current FAQ contents are out of date.  They would need a lot
>>> of work to update/correct them.
>>>
>>> Although the FAQ's are presented in a way that is OK for the user, the
>>> static HTML source is structured in a way that will be painful to
>>> maintain.   Getting a cleaner structure, for example using HTML
>>> definition lists (<dl>) would be easier and could be maintained via
>>> the CMS web interface.
>>>
>>> There is another set of FAQ's on the documentation wiki:
>>> http://wiki.openoffice.org/**wiki/Documentation/FAQ<http://wiki.openoffice.org/wiki/Documentation/FAQ>
>>>
>>> These also appear to be unmaintained.  But I think the wiki version
>>> would be easier to maintain.
>>>
>>> So one possible resolution could be:
>>>
>>> 1) Take anything of use from the FAQ's at
>>> http://www.openoffice.org/faq.**html 
>>> <http://www.openoffice.org/faq.html>and copy them into new FAQ items on
>>> the wiki
>>>
>>> 2) Update the other FAQ's on the wiki
>>>
>>> 3) Add new items to the wiki FAQ (like the iPAD question)
>>>
>>> 4) Delete the old FAQ directory and replace with a single page that
>>> directs the reader to the wiki FAQ's.
>>>
>>>
>>> -Rob
>>> -Rob
>>>
>>>  Regards,
>>>>    Andrea.
>>>>
>>>
>>>  Rob;
>>
>> I have been updating some of the FAQ's on the wiki site that were tagged
>> as needing help. I am more than willing to start a comprehensive review and
>> clean-up of the User FAQ's on the documentation wiki if that is the way we
>> decide to go. The advantage is that the wiki is easier to maintain and it
>> is already categorized with a toc on the main page.
>>
>> Regards
>> Keith
>>
>>
>>

Reply via email to