On 17/10/2020 08:25, Pascal Obry wrote:
I suppose one difficult point would be to reuse existing translation
but this is very important. The pr_BR manual is up to date and the
fr_FR one is 90% (was complete for 2.6). As translating the manual
needs countless hours we cannot tell the translators to start from
scratch again.
Bear in mind that I've done quite a lot of rewording and reorganisation
of paragraphs, and there is a fair bit of new content. Much of the
manual was written by non-native speakers and though technically
accurate a lot of the wording needed copy-editing.
At a rough estimate you should expect the translations to end up perhaps
no more than 50-60% complete in the best-case scenario.
On 17/10/2020 08:39, Pascal Obry wrote:
I don't agree with that since most of the documentation is written by
the developers themselves. Having a separate repo will make ensuring
the documentation is updated even harder. And I do really care about
documentation as I have pushed hard recently to have things regularly
updated.
Now for the translators it shouldn't make a difference since a weblate
will be used to update/translate if I have properly understood.
All in all, in my experience having the documentation next to the
project is always better.
I'm still of the opinion that the benefits of a separate repo far
outweigh the negatives. I understand that you don't like having to
monitor a second repo but you don't necessarily have to be the main
maintainer for dtdocs - Mica and I are more than happy to shoulder that
responsibility and it's clear that we will have other volunteers now
that the format has been simplified. I've put in well over 500 hours on
this project already, so I think I've demonstrated a dedication to
getting and keeping the docs up-to-date. It's also important for these
sort of things to be copy-edited by native English speakers and you
would end up having to make non-technical people maintainers on the main
darktable project - which seems risky. Plus the issues around
pre-implementation code freezes and the fact that the manual updates
often trail behind the releases by a couple of months. It seems like
maybe you're also arguing that developers can't cope with having to
update more than one repo?
There's no argument with dtorg, rawspeed and lua-scripts being separate
repos so I don't really see the difference here.
___________________________________________________________________________
darktable developer mailing list
to unsubscribe send a mail to darktable-dev+unsubscr...@lists.darktable.org
