Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate documentation #3234

Open
pierreozoux opened this issue Apr 29, 2021 · 44 comments
Open

Translate documentation #3234

pierreozoux opened this issue Apr 29, 2021 · 44 comments
Labels

Comments

@pierreozoux
Copy link
Member

It looks like it is currently not translated.

Would you be interested to have the doc translated?

@dhebert91
Copy link

Thank's Pierre for this issue. I'd like to contribute to the translation of this documentation : https://docs.nextcloud.com/desktop/2.6/

@FlexW
Copy link

FlexW commented Apr 29, 2021

I don't think it makes sense to translate https://docs.nextcloud.com/desktop/2.6/ as this an old version. The newest documentation can be found here https://docs.nextcloud.com/desktop/3.2. Having that said, I think it would be great to have translations for the documentation. However, I'm unsure how this can be achieved in an efficient way. Could we use Transifex for that? I think this would require some work from our side to change the infrastructure? @mgallien @er-vin @Valdnet

@Valdnet
Copy link
Contributor

Valdnet commented Apr 29, 2021

Could we use Transifex for that?

Documentation must be attached to Transifex to be fully translated into the various languages.

User documentation for the Nextcloud instance already exists in Transifex and is translated 100% in three languages.

@p-bo
Copy link

p-bo commented Oct 14, 2021

Any news regarding possibility to translate desktop client documentation please? Is it possible to use the same mechanism as in case of https://github.com/nextcloud/documentation/tree/master/user_manual/locale (thus what is remaining is to adapt the same recopies and connect to newly created subproject on Transifex) , or is there some difference and completely different approach is needed?

@FlexW
Copy link

FlexW commented Oct 14, 2021

@tobiasKaminsky @mgallien @allexzander @camilasan What do you think? Is that a task worth putting on the board? Or do we even want that?

@pierreozoux
Copy link
Member Author

As I did the plumbing for the user manual, I could do it also. I think it is a one day work.

Let me know :)

@p-bo
Copy link

p-bo commented Oct 14, 2021

@FlexW Just curiosity (all in positive and constructive mindset) – why this attitude whether it is worth or even wanted?

Localization (of user interface and documentation) is one of important pieces to cope with digital divide (and FLOSS software is serving there very well due its spirit) - not everyone had / has / will have luck to learn English (older users, who were historically forced to learn some other language(s); then people from disadvantaged, undeserved communities, etc.) I do understand, that it is difficult to have empathy with others, when one didn't have experience with their problems (is fluent in English), but please imagine situation, when your language skills are outdated (and irreplaceable, because your mental capabilities are affected by age) or non-existent (you haven't access to education of sufficient quality) and that state is not result of your own fault…

P.S.: as you see, human resources to implement this and maintain translations volunteered already - thus no additional burden for you ;-)

@Valdnet
Copy link
Contributor

Valdnet commented Oct 14, 2021

In my opinion, it's nice to read in your native language. It takes care of users (the older ones too) and adds seriousness to the application.

@tobiasKaminsky
Copy link
Member

@tobiasKaminsky @mgallien @allexzander @camilasan What do you think? Is that a task worth putting on the board? Or do we even want that?

We can help with setting it up. Translation is done by our awesome community 👍

@tobiasKaminsky
Copy link
Member

As I did the plumbing for the user manual, I could do it also. I think it is a one day work.

Let me know :)

Ah, cool, that you want to help :-)
Please do it 💙

If you need any help, e.g. in creating new resources in Transifex just write here.

@pierreozoux
Copy link
Member Author

Ok, I'll prioritize this :)

@pierreozoux
Copy link
Member Author

@tobiasKaminsky are there any good reasons of not having this inside the doc repo directly?

Doing it for the user manual was already tedious, and it is still not over.

I think I'd prefer to have it there as well, I think it makes more sense.

Then the project would be to move this repo there as a subfolder. If you are ok with the idea, I could do the work as well.

Let me know.

@tobiasKaminsky
Copy link
Member

As discussed with @AndyScherzinger it is okay to move this to doc repo.
If you want to do this, this would be awesome! 🎉
If you need any help, please just ping here.

@p-bo
Copy link

p-bo commented Feb 2, 2022

@pierreozoux Hi, how it looks regarding this please? There is another request for this: nextcloud/documentation#7729

@rakekniven
Copy link
Member

As I wrote in linked issue:

As the client is a very popular part of Nextcloud and there are plenty of questions regarding it at the forums it would help to have it localised.

Please move content to documentation repo and add it to Transifex.

@mgallien
Copy link
Collaborator

mgallien commented Feb 3, 2022

I am under the impression that adding client documentation in the server documentation repository would lead to complication in particular to be able to align desktop client and matching documentation in a repository where branches currently are used to do that aligned with server releases
I can be proven wrong but I feel like it would probably be easier to just sync the client documentation to transifex like it is done for server documentation

@pierreozoux
Copy link
Member Author

Ok, I was thinking to move this folder:
https://github.com/nextcloud/desktop/tree/master/doc
here:
https://github.com/nextcloud/documentation/tree/master/user_manual

But yeah, it is versioned with server version...

I think you are right @mgallien as I did the other automation, I'll copy it here. I'll start today.

@mgallien
Copy link
Collaborator

mgallien commented Feb 4, 2022

Ok, I was thinking to move this folder: https://github.com/nextcloud/desktop/tree/master/doc here: https://github.com/nextcloud/documentation/tree/master/user_manual

But yeah, it is versioned with server version...

I think you are right @mgallien as I did the other automation, I'll copy it here. I'll start today.

Thanks a lot @pierreozoux

@p-bo
Copy link

p-bo commented Feb 4, 2022

@pierreozoux Thanks for your dedication!

@rakekniven
Copy link
Member

Hello,

good point about the versioning. I will close my issue in docu repo.

Another point is the style of the client docs. They are display differently to the server.
Both use Sphinx, or?
Can we align the style?

In the future there will be more docs. I am planning to write something for the iOS app and for sure I will use sphinx as well.

@p-bo
Copy link

p-bo commented Feb 4, 2022

@rakekniven Sorry for hijacking this thread a bit, but it would be great to resurrect docs for Android app too - see nextcloud/documentation#1583 - in any case noble idea to improve situation with non-existent docs regarding mobile client(s)!

@rakekniven
Copy link
Member

but it would be great to resurrect docs for Android app too

Hello @p-bo Happy to have you on board. Feel free to start.

@p-bo
Copy link

p-bo commented Jun 3, 2022

Just for reference - @pierreozoux created/fixed localization synchronizing/merging to/from Transifex in doc repo (for server user docs) and hopefully will port this solution also into this repo for client docs. Really appreciated!

@rakekniven
Copy link
Member

Really appreciated!

Absolutely. 🚀

@pierreozoux
Copy link
Member Author

@p-bo sorry it takes so long..
I'm actually still not happy there..
and this is not something I can test on my machine :/
I really want to fix it for good there, and then I just need to copy here.
hopefully next week it will be good :)

@rakekniven
Copy link
Member

Hello @pierreozoux Any news here?

@pierreozoux
Copy link
Member Author

@mgallien
Copy link
Collaborator

@pierreozoux @rakekniven
status of this is unclear to me
do we have any technical issues blocking this ?

@rakekniven
Copy link
Member

@mgallien Thanks for picking up on this!

Please see conversation at nextcloud/documentation#8498 (comment) I was asking Pierre and skjnldsv about a summary of the problems.

@pierreozoux
Copy link
Member Author

@mgallien @rakekniven my thinking around this topic is still the same and is documented here indeed :)

And I think we should normalize all Nc projects to follow same approach.

In the coming weeks, I'd have an hour to discuss about this during a visio if somebody from Nc wants and agree with all stake holders that this is our wish.
And about the proposition to do it, I'll be able to do it in April or May, there is roughly a week of work I think.

@DaphneMuller
Copy link

@pierreozoux @rakekniven just FYI @mgallien will reach out to you beginning of next week to schedule a call to align next steps :)

@rakekniven
Copy link
Member

Hello all,

personally I am interested to have the client manual translated and you can get a lot of applause from the community.

Technically I cannot help and be the wrong person to participate the call. I think @skjnldsv will be the right person as he has been part of the discussion tech side.

@mgallien
Copy link
Collaborator

mgallien commented Mar 1, 2023

@rakekniven sent a direct mail to @pierreozoux and @skjnldsv
feel free to told me if you would still like to be involved

@skjnldsv

This comment was marked as resolved.

@skjnldsv

This comment was marked as resolved.

@skjnldsv

This comment was marked as resolved.

@skjnldsv
Copy link
Member

skjnldsv commented Mar 1, 2023

Automated process fix is in nextcloud/documentation#9669 Please review and approve

Then we can merge and trigger the automated update again.

Merged, triggered and fully functional with auto merge! 🚀
Feel free to use the same process for this documentation so everyone can translate.
Once this is setup on this repo, I can help configuring transifex for this. It's been a while but I can.

For this repository, I see a few issues already:

  1. The theme used is still the old nextcloud one, we moved to readthedoc long time ago
    https://github.com/nextcloud/documentation/blob/ef5f563a259e0c07e32a11f6dc90a5148281bda7/requirements.txt#LL4C26-L4C26
  2. Then we have the lang local config
    https://github.com/nextcloud/documentation/blob/ef5f563a259e0c07e32a11f6dc90a5148281bda7/user_manual/conf.py#L317
    nextcloud/documentation@81e8a66

This is not a tiny amount of work though nextcloud/documentation#2549

@rakekniven
Copy link
Member

@pierreozoux Is that good now for you to invest your work (appreciate it)?

@rakekniven
Copy link
Member

Hello @pierreozoux , the project folder of the client documents at Transifex is still empty. See https://www.transifex.com/nextcloud/nextcloud-client-documentation/dashboard/ This is as expected, isn't it?

Are there still technical hurdles for the implementation?
Or is it, as so often, a pure lack of time? ;-)

Thanks for any feedback.

@p-bo
Copy link

p-bo commented Mar 10, 2023

Many thanks to @skjnldsv for his part! - and it already helped in case of server user docs translations update right now (did my part for my native language there).

Regarding (also really appreciated and looked for regarding translating itself) work on adjusting of client docs for new workflow, Pierre stated regarding his availability above:

to do it, I'll be able to do it in April or May

@rakekniven
Copy link
Member

Yes, I have seen this comment. Just asked for a one line confirmation :-)

Have a nice weekend.

@p-bo
Copy link

p-bo commented Jun 4, 2023

Hello @pierreozoux,

hope you are doing well. Please, are there any news regarding this please?

Have a nice day :-)

@Rello
Copy link
Contributor

Rello commented Nov 25, 2024

...to be followed up...

@rakekniven
Copy link
Member

...to be followed up...

Who to trigger? I would really like to see a translated manual. Issue is now 3 1/2 years old.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests