Uwe Fischer wrote:
what would be the correct place to copy the blog entries to? For
example, the blog entry
http://blogs.sun.com/oootnt/entry/adding_more_languages_to_ooo obviously
belongs to
http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/FormattingText
But there are already some FAQ entries which cover the blog topic in
parts or that are closely related. Just copying the blog entry would not
look good.
You could try to consolidate the corresponding FAQs into one,
where applicable.
And the whole page is to be divided into separate pages anyhow. And I
don't like the idea that the entry I'm linking to from the application
help will be changed by someone who doesn't know it is referenced from a
certain application help page, may be adding some special developer info
to a page that is aimed at the beginner user, or deleting some
paragraphs because they can be found at another place, and so on.
The link to the FAQ is meant to complement the help info. It should not
contain information that must never be changed.
And translators would not want to translate such a whole long page like
http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/FormattingText
just because a link exists to one subtopic.
So I would like to have separate pages for all the FAQ topics first.
We are looking for splitting those pages up, yes. You could start by
just creating a designated page with the blog content and linking it
from the FAQ page.
Then I can easily copy blog pages to the Wiki and mark them as "this is
linked from the application help - please do not change it too much".
I am not sure if this is necessary. Who would define what "too much"
means. The wiki pages must be comprehensible as such and not depend on
the help content and vice versa. The wiki page content may get changed
but it will presumably still cover the topic it was created for.
You don't expect a "Adding more languages to OOo" page to
turn into a "How to cycle with both eyes closed" page.
And I would like to have the time to read through all the FAQ pages and
insert links to them from the application help where applicable.
Yes, we can do that for a 3.x release.
But then, we plan to publish the application help pages as Wiki pages
anyhow, so where is the benefit? May be this: the application help
The benefit is for the users that look in the application help
and see links to other resources.
*must* get translated, no matter if on the Wiki or not, while the other
Wiki pages *can* be translated.
That would be one approach, yes. Or rather distinguish between
core help and extra documentation (like FAQs, etc).
Frank
--
Frank Peters, Documentation Project Co-Lead
The OOo Documentation Project:
SIGN UP - PARTICIPATE - CONTRIBUTE
IT'S FREE! NO OBLIGATIONS!
http://documentation.openoffice.org
http://wiki.services.openoffice.org/wiki/Documentation
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
