Re: [hibernate-dev] documentation translations
Ok, then I will drop the 'en-US' part from the path.
A related discussion about the 'html' versus 'html_single' paths.
Currently the asciidoctor outputs are put into the 'html' path, but what
goes there is what is normally considered html-single. At the moment
Asciidoctor does not offer chunked html rendering, hence why we only render
the one "html single" output.
But to be consistent, I think we should rename the "html" in these asciidoc
paths to "html_single". I have changed the build for 5.1 to only generate
one docbook doc (integrationGuide) until we get that one migrated. That
way we have consistency between docbook and asciidoc outputs but also in
what is normal usage.
On Thu, Feb 11, 2016 at 11:46 AM Vlad Mihalcea <mihalcea.vlad(a)gmail.com>
wrote:
I think it's nearly impossible to keep documentation to date
across
several languages.
If the users haven't complained that we didn't maintain the non-English
docs,
I'd suppose we could simply focus on the English version only.
Google Chome does a decent job when translating articles from English to
other languages anyway.
Vlad
On Thu, Feb 11, 2016 at 6:57 PM, Steve Ebersole <steve(a)hibernate.org>
wrote:
> The translations of the ORM documentation (at least) is completely out of
> date. Has been for many years. To the point where we stopped even
> publishing translations.
>
> So at this point, as we migrate to Asciidoc(tor) and make changes to doc
> hosting do we plan for eventual translations? Or do we move forward
> assuming no translations?
>
> At the end of the day this is a simple point in that I need to know
> whether
> to preserve the en-US directory in the publishing or not. But if we do
> not
> plan on having translations, it seems odd to even deal with these language
> dirs.
>
_______________________________________________
> hibernate-dev mailing list
> hibernate-dev(a)lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev
>