Comments (13)
We are waiting for jp dir with already translated (almost fully) 🇯🇵 Japanese documents of lit-html, also LitElement, PWA Starter Kit !
https://lit-html.polymer-jp.org/
https://lit-element.polymer-jp.org/
https://pwa-starter-kit.polymer-jp.org/
https://www.polymer-jp.org/
repo -> https://github.com/Polymer-Japan/lit-html-docs-jp/tree/jp-translate/docs
from lit.dev.
@howking This is super cool. As Keanu said, I don't think we're going to be able to handle localized versions of the official docs anytime soon. I think the best thing we can do is figure out a way to highlight community resources like this.
from lit.dev.
That seems like a good approach. I think it's even possible to make that work with our own domain (e.g. v1-0-0.lit-html.polymer-project.org), at least if I'm reading this Stack Overflow answer correctly.
Not going to actually try to set up the DNS now, but can revisit this when lit makes a change that requires another site version.
from lit.dev.
I think a subdirectory makes a lot more sense. Then we can add new versions without mucking with DNS. Can we just namespace all the docs in /v1/
or /1.0
right now?
from lit.dev.
Discussed this offline and decided that given uncertainty about the direction we're going, it doesn't make sense change the URL structure at this point. Going to drop the priority on this a little bit and defer until after 1.0.
from lit.dev.
I think it'd be good to figure out at least a lightweight way of doing this before 1.0 so we have stable URLs. We can probably just put the .md files in sub folders for now and manually copy folders on new releases.
from lit.dev.
ping @keanulee @arthurevans @katejeffreys @frankiefu @yuinchien
from lit.dev.
🙇♂️ Someone attention please !
from lit.dev.
We don't have enough resources on our team to maintain translations. Even if someone provides a snapshot of translations now, moving forward we can't realistically update them as we release new versions.
from lit.dev.
😄 Thanks for reply ! OK, We'll keep working on translated repos, and happy from somewhere link, even create PRs at localize-dir ready.
from lit.dev.
@keanulee I don't think our current infrastructure gives us any great way to version the docs. One (somewhat sad) possibility would be to simply upload official versions as, for example, v1.0.0 to app engine, and add a dropdown that lets people switch sites. (So, basically, if you were looking at an old version you'd be looking at v1.0.0-dot-polymer-lit-html.appspot.com).
We could put the list of versions in the latest docs as, say, '/versions.json', so every version could load the same list from a canonical URL.
from lit.dev.
FYI 👂
This is our temp config for Japanese API Document with typedoc-plugin-localize.
(working LitElement too!)
from lit.dev.
Lit.dev now has a version selector and a way to add new versions going forward.
from lit.dev.
Related Issues (20)
- Dark Mode trigger icons are reversed if already in prefers-color-scheme(dark) HOT 4
- [lit-labs/virtualizer] Add documentation for the keyFunction property
- Missing docs for Form Associaed + ElementInternals
- Write a README for Algolia
- JavaScript Context Docs / Examples HOT 1
- [Dark Mode]: a suggestion
- [docs] Update decorator with babel section
- Add BBVA to customer list
- [docs] Document `mathml` tag and `unsafeMathML` directive
- How to import customElement, property from bundle HOT 2
- [docs] Add community libraries page to Related Libraries HOT 2
- Component example code does not compile HOT 1
- [meta] Skip PR preview comment workflow for forks
- bug: Broken links in the source code in issueWarning() HOT 3
- feat: Clarify keyed lists behavior
- [docs] showcase example of SSR with VM module
- Playground/tutorials output is not displayed correctly. It says 'Not found' HOT 2
- Controllers documentation uses deprecated lit labs types
- Document that `<select>` will remove HTML Elements
- Documentation on expressions should be updated HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from lit.dev.