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

translations #252

Closed
shanejonas opened this issue Dec 23, 2019 · 3 comments
Closed

translations #252

shanejonas opened this issue Dec 23, 2019 · 3 comments
Assignees

Comments

@shanejonas
Copy link
Member

shanejonas commented Dec 23, 2019

There are 2 separate things to consider with translations:

  1. As a developer, I'd like the OpenRPC spec translated to different languages, maybe the spec.open-rpc.org website that is generated can support loading different languages via a dropdown?

  2. As a user of the documentation or generated tooling, I'd like the descriptions in different languages, could start out as a plugin maybe x-description-fr for french as an example.

@BelfordZ
Copy link
Member

All for people maintaining mirrored translated copies of the spec. However, It's hard enough writing specification-worthy english, I cannot agree to maintaining official translated versions at this time.

That being said, perhaps you could add a link on the website repo to translated versions.

@open-rpc open-rpc deleted a comment from ChrisXK Jan 6, 2020
@BelfordZ
Copy link
Member

@ChrisXK Please do not post links to downloadable documents here. Microsoft word is potentially a publishing format, but it's not acceptable to post here due to security concerns. I hope you understand.

Can we discuss a way to have the spec translated in an ongoing, maintainable fashion?

A good solution should:

  • Allow the spec to be maintained in english. For now, all contributions must be made in english.
  • When a pull request is merged that changes the spec, a new set of translation tasks are created for the change set.
  • New github issues are created with the requested translations, and assigned to our translation buddies
  • When the issue is closed, a bot sweeps the closed translation issues and makes a PR adding the translations into a 'translation map': a structure for getting the translated copy of a given paragraph of text.
  • update the publish process to include publishing for multiple languages.

@stale
Copy link

stale bot commented Jun 13, 2020

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

@stale stale bot added the stale label Jun 13, 2020
@stale stale bot closed this as completed Jun 20, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants