Skip to content

Can you add documentation? #1

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

Closed
ka05 opened this issue Mar 20, 2018 · 3 comments
Closed

Can you add documentation? #1

ka05 opened this issue Mar 20, 2018 · 3 comments

Comments

@ka05
Copy link

ka05 commented Mar 20, 2018

@hilljh82 This is more of a request than an issue. Hope you don't mind.

Upon starting to use DBFlow I took a look at the PR you were involved in: agrosner/DBFlow#1091

I was hoping that it would be merged in soon, but since it doesnt look like that will happen anytime soon, I figured I would check out your project.
So i landed here and looked through some of the source but im having trouble seeing how much of this fits together. It would be awesome if you had some documentation or even just a few examples

In particular im interested in the usage of Loaders and Cursors with DBFlow but im also interested in the backbone-data module you have here!

At a quick glance it appears to be an attempt to abstract web service calls / caching / and DBFlow handling out into a module.

@hilljh82
Copy link
Contributor

hilljh82 commented Mar 20, 2018

@ka05 Sure, I can add some documentation for the Loaders and Cursors, which have not be merged into DBFlow.

Also, backbone is just a personal project that contains main components/classes that I reuse on many of my projects. Instead of making one single project, I have created several smaller projects to improve modularity.

In regards to the "web service calls / caching / and DBFlow handling out into a module" comment, the backbone-data project is my current attempt to implement ember-data in Java.

I personally grew tired of creating a backend api, and then having to implement the same code on Android for retrieving the data and storing the data in a SQLite database. So, backbone-data is designed to make it where you can define your data models in DBFlow (i.e., resources), and then make corresponding requests to an api server for those resources. The Cursors and Loaders that you speak about above make it where the views are automatically updated once the remote api call is complete. Right now, backbone-data use REST api format as explained inember-data instead of JSONAPI.

I will make sure to add documentation for backbone-data.

@hilljh82
Copy link
Contributor

@ka05 I have added documentation in the form of a README

https://github.com/onehilltech/backbone/tree/master/backbone-dbflow

@ka05
Copy link
Author

ka05 commented Mar 21, 2018

@hilljh82 Thank you very much! And for being so quick to reply and take the time to write up the readme. I will read it over in more detail tomorrow. Thanks again.

@ka05 ka05 closed this as completed Mar 21, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants