[udig-devel] Done (more or less) with German user guide

[Jody Garnett]

Matthias Basler wrote:
> Hi uDiggers,
>
> The German uDig user guide space has seen a rather large maintenance lately. I have converted the English page names to German, removed the TOC, have fixed all the numerous distorted special characters (hopefully never again), fixed several missing images, referenced English pages where German ones are not yet available and even added a bit of new content:
>   
Wow - just reading over it now. Looks great.
> Quickstart: http://udig.refractions.net/confluence/display/DE/Schnelleinstieg
> Services:
> http://udig.refractions.net/confluence/display/DE/Dienste
> File formats:
> http://udig.refractions.net/confluence/display/DE/Dateiformate
>
> Still lots of pages exist in English only, but since 99% of German people working with a GIS can speak English anyway ... not something to worry about.
>   
Thanks it makes a great impression, I will export out this space and 
include it in the help plugin on Monday.

> Comment #1:
> I tend to group several of your "micropages" into one larger page and reference subsections (anchors) instead of the single pages. This means less maintenance imho.
>   
Fair enough; I tired to only make small pages when we had specific views 
/ dialogs / wizards - the reason I did this is because the context 
sensitve help will be able to find the "Catalog" page when the user 
presses F1 in the "Catalog view". I imagine it will find the larger page 
as well; if I was writing the index words that appear in a heading would 
get more weight.

When you write a longer page you may find it useful to include a: {toc} 
macro near the top; now that this marcro exists I will be making use of 
longer pages myself.
> Comment #2:
> On this
> http://udig.refractions.net/confluence/display/EN/File+Formats
> page the currently supported file formats are listed. If I am not mistaken uDig 1.1 supports more by now, doesn't it? What about TIFF/TFW, BMP and other image data?
>   
You are correct; that page has not been updated; feel free just to add 
an entry for each format as you find gaps.
> There has been a discussion about the naming of world files recently. Could the result of this discussion please fed into this page. It would fit in nicely there.
>   
I think it is already there in the concepts page or something; but yes 
we should make it available near the description of the world image format.
> Comment #3:
> As you can see in the new pages I have added liks to Wikipedia for WFS, WMS, Shapefile and so on. Why write all the details if they are already nicely explained. I suggest to do the same in the English help as well.
>   
Sounds good; there were two reasons:
- these docs were started before wikipedia had this sort of content; you 
will find I already link to wikipedia in a few examples)
- these docs are all that there is when using uDig offline
> I would be glad if someone could please try to build an online help from this and check if the outcome is as expected.
> That's it for now.
>   
Amazing work; thank you very much Matthias. I would like to make an 
1.1.RC15 this week and if nothing horrible happens we can rebrand that 
as the 1.1.0 release. So the last thing left is a mac osx installer; how 
many mac users are around who would find this worthwhile?

Jody