[Libreoffice-qa] Uploading Edited Manual

[k-jw]

Hi Joel, *,
(ccing the documention-ml)

Hi All,
Where do I upload an updated manual. I made an incredibly small change
to address a bug report that someone had:
https://bugs.freedesktop.org/show_bug.cgi?id=41600

I've done about a paragraph addition just to address the language issue
that the user brought up. Can I send this somewhere? Thanks in advance.

For questions about documentation it is better to write to documentation-ml (documentation@global.libreoffice.org). There you will get (hopefully) the right answers and help.

Changes in documentation should be first published in ODFAuthors. You should work on the existing document.

If it is too difficult to do it for you, give a short signal. It should be easy to integrate your work.

Here some links for more information:

http://wiki.documentfoundation.org/Documentation
http://wiki.documentfoundation.org/Documentation/Production#Workflow

[Tom_Davies]

Hi
I think, in this case, that it might be better to just upload straight to the wiki
http://wiki.documentfoundation.org/Documentation/Publications

ODFAuthors is for proof-reading and all the rest of the process.  This case sounds like it is probably ready to go straight to the wiki.  Please let us know which chapter and when you have done it as the change might need to get pulled into the completed full book as well as the chapter you have edited.

Regards from
Tom

[Tom_Davies]

Hi
I think, in this case, that it might be better to just upload straight to the wiki
http://wiki.documentfoundation.org/Documentation/Publications

ODFAuthors is for proof-reading and all the rest of the process.  This case sounds like it is probably ready to go straight to the wiki.  Please let us know which chapter and when you have done it as the change might need to get pulled into the completed full book as well as the chapter you have edited.

Regards from
Tom

[jeanweber]

I disagree. The changed document should be checked by someone on the
team (for example, me) before replacing anything on the wiki.

--Jean

[Tom_Davies]

Hi
+1
Sorry.  Now i have thought about it that final sentence of mine flags up a potential minefield.  Klaus-jürgen and Jean's answer is wise.
Apols and regards from
Tom

[Tom_Davies]

Hi
+1
Sorry.  Now i have thought about it that final sentence of mine flags up a potential minefield.  Klaus-jürgen and Jean's answer is wise.
Apols and regards from
Tom

[Joel_Madero]

Thanks for the info. I'm slightly confused, am I uploading to wiki or
following Jean's advice and letting someone proof it before? It's honestly
a really simple addition. It's more to address the user who submitted the
request and knock one of the 5,000+ bugs off the list I can even post it
here:

*This is pertaining to bug reported here*:
https://bugs.freedesktop.org/show_bug.cgi?id=41600

*The original text is located in:*
Install the required dictionaries

*It reads:*
LibreOffice automatically installs several dictionaries with the program.
To add other dictionaries, be sure you are connected to the Internet, and
then use Tools > Language > More Dictionaries Online. LibreOffice will open
your default web browser to a page containing links to additional
dictionaries that you can install. Follow the prompts to select and install
the ones you want.

*I changed/added to the following:*
LibreOffice automatically installs several dictionaries with the program.
To add other dictionaries, be sure you are connected to the Internet, and
then use Tools > Language > More Dictionaries Online. LibreOffice will open
your default web browser to a page containing links to additional
dictionaries that you can install.

When you download the dictionary or dictionaries that you want, they will
be in the open office extension format (.oxt). In order to install these
extensions use Tools > Extension Manager...click on Add...located at the
bottom of the extension manager dialog. Navigate to the appropriate folder
containing your dictionary in .oxt format, select the oxt dictionary and
click Open.

Many thanks,
Joel

[jeanweber]

Is this in the full book or a chapter file or both? Please tell me the exact file names.

One reason I like to check files before uploading is to change info on copyright page if needed. Also sometimes changes to files cause page break changes that I want to correct or they've used an incorrect style or something. Fiddly stuff not directly related to the content.

Probably all is fine with what you've done, but I would like to check. If you don't have an ODFAuthors account, go ahead and upload to wiki. Just be sure to tell me the file name(s). Thanks!

Jean

[k-jw]

Hi,

Is this in the full book or a chapter file or both? Please tell me the exact file names.

One reason I like to check files before uploading is to change info on copyright page if needed. Also sometimes changes to files cause page break changes that I want to correct or they've used an incorrect style or something. Fiddly stuff not directly related to the content.

Probably all is fine with what you've done, but I would like to check. If you don't have an ODFAuthors account, go ahead and upload to wiki. Just be sure to tell me the file name(s). Thanks!

Maybe we should put some instructions for such cases on our main wiki page like:

"If you found some mistakes in our documentation there are different ways to change it:

1) Little mistakes: Tell it on the disscuss-ml with telling of file name, page, chapter, paragraph, sentence (or even other information to find quickly the position of the mistake) and your solution.

2) Bigger mistakes/changes:
Change it directly in ODFAuthors. Please don't change it in the wiki page.
If you aren't able to do it in ODFAuthors please tell the changes on documentation-ml like described in 1). Someone of the documentation team will take care of it."

This content can be posted on the most bug reports too.

By using [1] I only find three bugs in bug report that are concerned to documentation:
https://bugs.freedesktop.org/show_bug.cgi?id=42193
https://bugs.freedesktop.org/show_bug.cgi?id=41543
https://bugs.freedesktop.org/show_bug.cgi?id=40702

[1] https://bugs.freedesktop.org/buglist.cgi?order=Importance&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=VERIFIED&bug_status=NEEDINFO&bug_status=PLEASETEST&component=Documentation&product=LibreOffice