cncf / techdocs

CNCF TechDocs Team
https://www.cncf.io
Apache License 2.0
37 stars 26 forks source link

Initialize Localization READMEs template #260

Open Okabe-Junya opened 1 week ago

Okabe-Junya commented 1 week ago

Feature Descriptions

ref. https://github.com/cncf/techdocs/pull/259#issuecomment-2173954621

I think it would be good to have an English version of this as well (even if it's very rough or just an outline). I'd like to use this work as a template or starting point for other languages.

Okabe-Junya commented 1 week ago

cc @nate-double-u

Please take a look, thank you :)

nate-double-u commented 1 week ago

Thanks for this @Okabe-Junya!

/cc @a-mccarthy @chalin

Okabe-Junya commented 2 days ago

I see, I agree with your opinion, @chalin

but my feeling is that it’s too early to offer a template.

If there are no issues, I would like to close this PR within a week (or feel free to close this)

When the time comes to create such a template, please let me help!

a-mccarthy commented 1 day ago

but my feeling is that it’s too early to offer a template.

It might be too early for a template, but I think its still helpful to provide a checklist or bullet points of what folks should think about if they want to add localization into their project. The concepts behind what you included in this guide @Okabe-Junya are really good, and a helpful start for someone who is maybe just starting

Even if we just start creating a list of good examples of localization being done by other projects, I think it would make it easier if you get questions later from a project looking to get started localizing.