Just curious as to why you don't spend your time updating the already existent docs by
@timdorr instead if spinning your own??
Great question. I have 3 reasons.
- Development Speed - Im working on a side project to build my own app for my cars/powerwalls and I'm able to move faster without external dependencies.
- Branding - Tim's Documentation, like this thread, revolves around Model S branding. When he first released his documentation, that was apt because the X, 3, Powerwall and Energy Site APIs weren't available. I want documentation that supports all of Tesla's products, not just the Model S.
- Timeline - Tim has an open issue and discussion from November, 2016 (Updated as recently as May, 2018) describing a process to migrate off API Airy. If there is a migration plan, I don't really want to contribute to something that may need to be re-written. I already spent a few days searching for the best place to host open source docs.
Tims have more Google presence and have links to it scattered all over TMC and the web...
Having two API docs floating around is pointless. If you want documentation that is up to date, why not focus on what already exists?
That is your opinion which is fine.
As a side note, I've heard that exact same comment multiple times even up to recently on Hacker News about a website called
gitignore.io that I started 5.5 years ago. They told me that
github.com/github/gitignore already had a list of templates, it was ranked higher on Google, it had more GitHub stars, etc... Today my site hosts 60-80k MAU's and multiple open source plugins and IDE integrations built on top of it because while the origins of the project seemed to be the same initially, my project solves creating .gitignore files more efficiently than GitHub. I also have double the amount of templates because the project owners at GitHub/Microsoft have different requirements and rules for what they see as a valid pull request.
However I'm happy to be proven wrong, have you attempted any PRs to Tims repo?
I'm not really into "proving people wrong or right" because it's irrelevant. Once I get my docs ironed out over the next few weeks, I'll submit some PR's back to Tim's docs.
Overall if you don't want to use the docs, that's totally fine, I made them for myself and I'm sharing them to those that want to use them. There are multiple posts in this thread with people commenting about how there is no unified documentation and that you have to scroll through every post to figure out different API calls. This is for those users.