[maemo-community] new docs to be imported to the mameo.org wiki

[From: Jarmo.Tikka at nokia.com]

Hi,

> Date: Fri, 23 Apr 2010 12:01:23 -0700
> From: Dave Neary <dneary at maemo.org>
> Subject: Re: new docs to be imported to the mameo.org wiki
> To: List for community development <maemo-community at maemo.org>
> 
> Hi,
> 
> Jarmo.Tikka at nokia.com wrote:
> > We use "official" tools but we have just created scripts on top of
> > them to integrate these official tools into Maemo documentation
> > infrastructure. And yes, I ask you to trust that our tools work as we
> > have tested them to work. If you find any actual problems from our
> > doc tools just let me know and we will fix them.
> 
> This is the point. If I find problems while importing docs into the
> maemo wiki, we could lose people's work.

No this is not the point. I copy-paste my answer from my previous email.

***
> We do not have (as I have said to you many times :) that problem about 
> over-writing wiki page history with successive imports. When pages are 
> imported to the same location to the wiki import just updates those 
> pages. Overwriting community changes may be a problem if changes are 
> not reviewed and taken to the official documents before next import 
> round. But even in that situation (as mistakes will happen) changes 
> are not lost as they are save in wiki page history.***
***

> Anyway, for these docs, they are mostly new, so I guess we will have to
> take the chance.

I have released these first time as PreFinal in January but they are new in Maemo.org wiki.

> 
> > I do not want to release MediaWiki converted versions (in addition to
> > HTML and PDF) from our documents as they are not so useful for normal
> > users/developers. To be able to import documents to the MediaWiki you
> > need MediaWiki converted versions and they can be done using maemo
> > doc toolchain and LaTex baseline files I already send links to you
> > couple of weeks ago. I had to remove those links but I can resend
> > them to you or provide ready-converted MediaWiki versions if you do
> > not want to do that yourself.
> 
> I'd appreciate it if you provided the converted versions, please.
> Thanks!
> 
> >>> Maemo.org wiki now has older versions (PreFinal versions from here
> >>> (http://tablets-dev.nokia.com/maemo-dev-env-downloads.php) that
> need
> >> to
> >>> be updated to be in sync with Info Center.
> >> Do you know how to update these files?
> >
> > You can update all imported document just by re-importing on top of
> them. Now when you have used your own method to import current versions
> I am not sure anymore how to update them but I propose you try to
> import new versions on top of them and see what happens. If updating
> dos not work you need to start from scratch. You anyhow need to fix all
> those imported docs in wiki because there are no pictures at all in
> current doc set.
> 
> I mean, do you know how to get your latest versions of the various
> files on http://tablets-dev.nokia.com/maemo-dev-env-downloads.php uploaded
> there, so that they're available to all?

All documents are already available for download from Maemo Info Center. I used this Maemo development environment downloads page to release PreFinal document versions only because I did not have Info Center yet ready for publishing them.

I will remove those PreFinal versions from tablets-dev site downloads as soon as I have also Hildon UI and UI Widget guides released (full set of Fremantle docs) in Info Center. New LaTex baseline and will be available also from Info Center in May.

I plan to continue delivering documentation toolchain from tablets-dev site or should I deliver also toolchain from Info Center together with actual documents and baseline?

> 
> > I will resend you those download links again for ready-converted
> MediaWiki versions of these documents.
> 
> Thank you very much!

No problem.

Cheers,
//Jarmo

> 
> Dave.
> 
> --
> maemo.org docsmaster
> Email: dneary at maemo.org
> Jabber: bolsh at jabber.org
>