Some more work on the kinto intro, version 2 #92
Conversation
| @@ -14,7 +14,7 @@ What can Kinto do for me? | |||
| Kinto — the project we are working on since quite some time now — can do a bunch | |||
| of different things for you and be useful in many different situations. | |||
|
|
|||
| However we found out that it is really hard to understand at a glance what it | |||
| Howevern, we found out that it is really hard to understand at a glance what it | |||
Natim
Jan 6, 2016
Contributor
However right?
However right?
almet
Jan 6, 2016
Author
Collaborator
yup, typo.
yup, typo.
| @@ -23,14 +23,124 @@ Here is an attempt to fix this. | |||
| Kinto is not a framework | |||
| ######################## | |||
|
|
|||
| First and foremost, Kinto is not a framework. Kinto is meant to replace the | |||
| First and foremost, Kinto is not a framework. It doesn't try to provide a way | |||
| to structure your projects for yoi. It is meant to replace the | |||
Natim
Jan 6, 2016
Contributor
structure your projects for you?
structure your projects for you?
| Kinto with React, Angular, JQuery (in the JavaScript world) or any framework in | ||
| any language. Kinto abstracts the synchronisation of the application's data. | ||
| Said differentely, you store your data locally for your application and **Kinto | ||
| will make this data available to different devices**. |
Natim
Jan 6, 2016
Contributor
devices or users.
devices or users.
almet
Jan 6, 2016
Author
Collaborator
s/for your application//
s/for your application//
| with Kinto really easily, but ultimately you don't need it. It's just here to | ||
| make it really easy for you to integrate with the HTTP APIs exposed by Kinto. | ||
|
|
||
| Synchronize your data |
Natim
Jan 6, 2016
Contributor
Synchronise
Synchronise
almet
Jan 6, 2016
Author
Collaborator
Nope, I'm using "z" on purpose here.
Nope, I'm using "z" on purpose here.
Natim
Jan 6, 2016
Contributor
Why not in the rest of the article then?
Why not in the rest of the article then?
almet
Jan 6, 2016
Author
Collaborator
It's a mistake ! :-)
It's a mistake ! :-)
| **synchronise** your data between different devices, there are chances that | ||
| Kinto is a good fit. | ||
|
|
||
| That's useful if you want to synchronize data between devices, and also between |
Natim
Jan 6, 2016
Contributor
synchronise
synchronise
| remote: "https://kinto.dev.mozaws.net/v1" | ||
| }).collection("tasks"); | ||
| XXX |
Natim
Jan 6, 2016
Contributor
const tasks = new Kinto({
remote: "https://kinto.dev.mozaws.net/v1"
}).collection("tasks");
tasks
.create({label: "First item", done: false})
.then(_ => tasks.sync());
const tasks = new Kinto({
remote: "https://kinto.dev.mozaws.net/v1"
}).collection("tasks");
tasks
.create({label: "First item", done: false})
.then(_ => tasks.sync());
almet
Jan 6, 2016
Author
Collaborator
I don't find this example compelling. I would like to have something that's able to synchronize an already existing array, for instance.
I don't find this example compelling. I would like to have something that's able to synchronize an already existing array, for instance.
| Storage | ||
| ======= | ||
|
|
||
| You're not only syncing your data between different locations, you're actually |
Natim
Jan 6, 2016
Contributor
You are
You are
| ======= | ||
|
|
||
| You're not only syncing your data between different locations, you're actually | ||
| storing it somewhere, on a location you chosed. |
Natim
Jan 6, 2016
Contributor
choose/chose/chosen
You have chosen? You chose?
choose/chose/chosen
You have chosen? You chose?
almet
Jan 6, 2016
Author
Collaborator
you chose.
you chose.
| You're not only syncing your data between different locations, you're actually | ||
| storing it somewhere, on a location you chosed. | ||
|
|
||
| You can access this data later on when you need. The cool thing here is |
Natim
Jan 6, 2016
Contributor
you need it
you need it
|
Thanks for the comments, I'll address them later on. |
| storing it somewhere, on a location you chosed. | ||
|
|
||
| You can access this data later on when you need. The cool thing here is | ||
| that you can access this data using an HTTP API that speaks JSON. |
Natim
Jan 6, 2016
Contributor
a HTTP API (aspirated h is prononced isn't it?)
a HTTP API (aspirated h is prononced isn't it?)
| Permissions | ||
| =========== | ||
|
|
||
| Sometimes, you want your data to remain yours, and some other times you want to |
|
|
||
| One of the reasons we built Kinto was to control who has access to what on a | ||
| per record level. Without getting too much in the details, the data stored in | ||
| kinto is organised into three concepts: Buckets contains collections wich in |
Natim
Jan 6, 2016
Contributor
Kinto
Kinto
| kinto is organised into three concepts: Buckets contains collections wich in | ||
| turn contain records. | ||
|
|
||
| It's then possible to apply permissions to each container, and all children |
|
|
||
| What happens when the data evolves? Let's say you are on one device doing | ||
| geo-mapping and someone else is doing the same thing on their own device. You | ||
| want to have these two devices in Sync, and as such they need to know when new |
Natim
Jan 6, 2016
Contributor
in sync
in sync
| <http://kinto.readthedocs.org/en/latest/concepts.html>`_ about this if you want. | ||
|
|
||
|
|
||
| Real-time Notifications |
Natim
Jan 6, 2016
Contributor
I am not sure about the capital N for notification.
I am not sure about the capital N for notification.
|
Make sure to put a capital K to Kinto otherwise it looks good to me :) |
|
Oh, I forgot about this one, do we want to land it? @n1k0 @leplatrem |
|
Any news? |
|
I think we should now merge it, it's been too long (we also need to change the date) |
|
Are you okay to merge this PR? |
| will make this data available to different devices. That means that you can use | ||
| Kinto with React, Angular, JQuery (in the JavaScript world) or any framework in | ||
| any language. Kinto abstracts the synchronisation of the application's data. | ||
| Said differentely, you store your data locally for your application and **Kinto |
glasserc
May 17, 2016
Contributor
differently
differently
| efforts using the tooling we have put together. You can leverage the | ||
| `Kinto.js <https://kintojs.readthedocs.org>`_ client, as it allows you to work | ||
| with Kinto really easily, but ultimately you don't need it. It's just here to | ||
| make it really easy for you to integrate with the HTTP APIs exposed by Kinto. |
glasserc
May 17, 2016
Contributor
I disagree with the idea that you don't need it. Kinto.js is pretty important for offline-first access.
I disagree with the idea that you don't need it. Kinto.js is pretty important for offline-first access.
almet
May 17, 2016
Author
Collaborator
I have done a bunch of projects without using Kinto.js because I wasn't needing any offline first access. Maybe we should rephrase this?
I have done a bunch of projects without using Kinto.js because I wasn't needing any offline first access. Maybe we should rephrase this?
glasserc
May 17, 2016
Contributor
I see now that this just got moved from elsewhere in the docs so maybe never mind about this comment.
I see now that this just got moved from elsewhere in the docs so maybe never mind about this comment.
|
I believe we should merge this. Otherwise I'll publish it elsewhere. Let me know what you prefer :) |
|
Can you rebase ? |
|
Yes let's merge it :) |
|
Rebased and added a reference to the formbuilder. |
|
"Permission to mozilla-services/servicedenuages.fr.git denied to almet", I've forked and pushed in my own branch, please use it there. |
|
https://github.com/almet/servicedenuages.fr/tree/kinto-intro-v2 I've rebased so please use this one there rather than the one here. |
Here is some more work on the introductional article. I'm mising an example of how to integrate simply with JavaScript. @n1k0, @leplatrem do you want to work on this? :-)