Cleaning up Voyage Documentation
Hi all, I am building a small app that uses Voyage and MongoDB as the database, and so I had many questions regarding how to use it and found the documentation lacking. After conversing with Esteban, I proposed that I improve the 'Pharo for the enterprise' chapter on Voyage, based on his responses to my questions. (See https://ci.inria.fr/pharo-contribution/job/PharoForTheEnterprise/lastSuccess... and https://github.com/SquareBracketAssociates/PharoForTheEnterprise-english/tre... for the sources) So a heads-up: I would like to take a 'lock' on that text for some days (to avoid conflicts and the associated unpleasantness), as I go improving and expanding it in the next few days. Also, if you have questions and/or remarks about Voyage and/or the documentation, shoot! I will do my best to address them. Greetings, ---> Save our in-boxes! http://emailcharter.org <--- Johan Fabry - http://pleiad.cl/~jfabry PLEIAD lab - Computer Science Department (DCC) - University of Chile
Hi Johan, I use MongoDB and voyage for www.spesenfuchs.de and it works fine for me. My remarks: 1) you could also add VOMongoTransientDescription (see class comment) and VOMongoToManyDescription to chapter "enhancing storage". 2) "VORepository current reset" is imo important to know. As far as I understand, it forces to reload all objects from database. I need this after changing the VOMongo....Descriptions. 3) I like the possibility to have a look into the values in the database. For this, there are 2 very useful tools: http://rockmongo.com/ for windows and http://robomongo.org/ for mac. I recommend to use it. Helps a lot. 4) I think as far as you start to implement a real app, you need this solution to implement circular references http://forum.world.st/Voyage-Circular-references-td4691940.html#a4703493 5) another not so important point http://forum.world.st/your-opinion-about-storing-FixedDecimal-in-Mongo-td470... 6) I think you do also know: http://esug.org/data/ESUG2013/4-Thu/03-ESUG2013%20-%20VoyageTutorial.pdf http://smallworks.com.ar/web/blog 7) Last point, you could add some words/thoughts about data migration: what do I mean with this? Today, my model is as it is. My app runs. Data is generated in MongoDB. But after e.g. one month, I decide to change my model. Now, there are 2 possibilities: migrate all data while installing the new version or some kind of "lazy" migration at the moment, the object is loaded from mongo (I do this within the magritte description). Both has advantages and disadvantages and depends on the situation. I am interested in other opinions and solutions for this. If I can contribute more please tell me. Regards Sabine On Wed, Nov 20, 2013 at 9:10 PM, Johan Fabry [via Smalltalk] < ml-node+s1294792n4723834h49@n4.nabble.com> wrote:
Hi all,
I am building a small app that uses Voyage and MongoDB as the database, and so I had many questions regarding how to use it and found the documentation lacking. After conversing with Esteban, I proposed that I improve the 'Pharo for the enterprise' chapter on Voyage, based on his responses to my questions. (See https://ci.inria.fr/pharo-contribution/job/PharoForTheEnterprise/lastSuccess... and
https://github.com/SquareBracketAssociates/PharoForTheEnterprise-english/tre... for the sources)
So a heads-up: I would like to take a 'lock' on that text for some days (to avoid conflicts and the associated unpleasantness), as I go improving and expanding it in the next few days.
Also, if you have questions and/or remarks about Voyage and/or the documentation, shoot! I will do my best to address them.
Greetings,
---> Save our in-boxes! http://emailcharter.org <---
Johan Fabry - http://pleiad.cl/~jfabry PLEIAD lab - Computer Science Department (DCC) - University of Chile
------------------------------ If you reply to this email, your message will be added to the discussion below: http://forum.world.st/Cleaning-up-Voyage-Documentation-tp4723834.html To start a new topic under Pharo Smalltalk Users, email ml-node+s1294792n1310670h65@n4.nabble.com To unsubscribe from Pharo Smalltalk Users, click here<http://forum.world.st/template/NamlServlet.jtp?macro=unsubscribe_by_code&nod...> . NAML<http://forum.world.st/template/NamlServlet.jtp?macro=macro_viewer&id=instant...>
-- View this message in context: http://forum.world.st/Cleaning-up-Voyage-Documentation-tp4723834p4723922.htm... Sent from the Pharo Smalltalk Users mailing list archive at Nabble.com.
Hi Sabine, thank you for your observations, interesting pointers and offer for help! I will integrate as much as possible and your comments are certainly welcome! I am not so knowledgeable about data migration, I understand what you are saying but I have no deep insights. I will add something about data migration to the documentation but I think it will be brief. Greetings, On Nov 21, 2013, at 6:16 AM, Sabine Knöfel <sabine.knoefel@gmail.com> wrote:
Hi Johan,
I use MongoDB and voyage for www.spesenfuchs.de and it works fine for me.
My remarks:
1) you could also add VOMongoTransientDescription (see class comment) and VOMongoToManyDescription to chapter "enhancing storage".
2) "VORepository current reset" is imo important to know. As far as I understand, it forces to reload all objects from database. I need this after changing the VOMongo....Descriptions.
3) I like the possibility to have a look into the values in the database. For this, there are 2 very useful tools: http://rockmongo.com/ for windows and http://robomongo.org/ for mac. I recommend to use it. Helps a lot.
4) I think as far as you start to implement a real app, you need this solution to implement circular references http://forum.world.st/Voyage-Circular-references-td4691940.html#a4703493
5) another not so important point http://forum.world.st/your-opinion-about-storing-FixedDecimal-in-Mongo-td470...
6) I think you do also know: http://esug.org/data/ESUG2013/4-Thu/03-ESUG2013%20-%20VoyageTutorial.pdf http://smallworks.com.ar/web/blog
7) Last point, you could add some words/thoughts about data migration: what do I mean with this? Today, my model is as it is. My app runs. Data is generated in MongoDB. But after e.g. one month, I decide to change my model. Now, there are 2 possibilities: migrate all data while installing the new version or some kind of "lazy" migration at the moment, the object is loaded from mongo (I do this within the magritte description). Both has advantages and disadvantages and depends on the situation. I am interested in other opinions and solutions for this.
If I can contribute more please tell me.
Regards Sabine
---> Save our in-boxes! http://emailcharter.org <--- Johan Fabry - http://pleiad.cl/~jfabry PLEIAD lab - Computer Science Department (DCC) - University of Chile
Hi Johann, thanks. I have a working solution for migration and possibly one day I will ask in the mailinglist for a diskussion about this. Regards Sabine On Thu, Nov 21, 2013 at 4:09 PM, Johan Fabry [via Smalltalk] < ml-node+s1294792n4723998h33@n4.nabble.com> wrote:
Hi Sabine,
thank you for your observations, interesting pointers and offer for help! I will integrate as much as possible and your comments are certainly welcome!
I am not so knowledgeable about data migration, I understand what you are saying but I have no deep insights. I will add something about data migration to the documentation but I think it will be brief.
Greetings,
On Nov 21, 2013, at 6:16 AM, Sabine Knöfel <[hidden email]<http://user/SendEmail.jtp?type=node&node=4723998&i=0>> wrote:
Hi Johan,
I use MongoDB and voyage for www.spesenfuchs.de and it works fine for me.
My remarks:
1) you could also add VOMongoTransientDescription (see class comment) and VOMongoToManyDescription to chapter "enhancing storage".
2) "VORepository current reset" is imo important to know. As far as I understand, it forces to reload all objects from database. I need this after changing the VOMongo....Descriptions.
3) I like the possibility to have a look into the values in the database. For this, there are 2 very useful tools: http://rockmongo.com/ for windows and http://robomongo.org/ for mac. I recommend to use it. Helps a lot.
4) I think as far as you start to implement a real app, you need this solution to implement circular references http://forum.world.st/Voyage-Circular-references-td4691940.html#a4703493
5) another not so important point
http://forum.world.st/your-opinion-about-storing-FixedDecimal-in-Mongo-td470...
6) I think you do also know: http://esug.org/data/ESUG2013/4-Thu/03-ESUG2013%20-%20VoyageTutorial.pdf http://smallworks.com.ar/web/blog
7) Last point, you could add some words/thoughts about data migration:
what do I mean with this? Today, my model is as it is. My app runs. Data is generated in MongoDB. But after e.g. one month, I decide to change my model. Now, there are 2 possibilities: migrate all data while installing the new version or some kind of "lazy" migration at the moment, the object is loaded from mongo (I do this within the magritte description). Both has advantages and disadvantages and depends on the situation. I am interested in other opinions and solutions for this.
If I can contribute more please tell me.
Regards Sabine
---> Save our in-boxes! http://emailcharter.org <---
Johan Fabry - http://pleiad.cl/~jfabry PLEIAD lab - Computer Science Department (DCC) - University of Chile
------------------------------ If you reply to this email, your message will be added to the discussion below:
http://forum.world.st/Cleaning-up-Voyage-Documentation-tp4723834p4723998.htm... To start a new topic under Pharo Smalltalk Users, email ml-node+s1294792n1310670h65@n4.nabble.com To unsubscribe from Pharo Smalltalk Users, click here<http://forum.world.st/template/NamlServlet.jtp?macro=unsubscribe_by_code&nod...> . NAML<http://forum.world.st/template/NamlServlet.jtp?macro=macro_viewer&id=instant...>
-- View this message in context: http://forum.world.st/Cleaning-up-Voyage-Documentation-tp4723834p4724292.htm... Sent from the Pharo Smalltalk Users mailing list archive at Nabble.com.
excellent we love co-authors Stef On Nov 20, 2013, at 9:04 PM, Johan Fabry <jfabry@dcc.uchile.cl> wrote:
Hi all,
I am building a small app that uses Voyage and MongoDB as the database, and so I had many questions regarding how to use it and found the documentation lacking. After conversing with Esteban, I proposed that I improve the 'Pharo for the enterprise' chapter on Voyage, based on his responses to my questions. (See https://ci.inria.fr/pharo-contribution/job/PharoForTheEnterprise/lastSuccess... and https://github.com/SquareBracketAssociates/PharoForTheEnterprise-english/tre... for the sources)
So a heads-up: I would like to take a 'lock' on that text for some days (to avoid conflicts and the associated unpleasantness), as I go improving and expanding it in the next few days.
Also, if you have questions and/or remarks about Voyage and/or the documentation, shoot! I will do my best to address them.
Greetings,
---> Save our in-boxes! http://emailcharter.org <---
Johan Fabry - http://pleiad.cl/~jfabry PLEIAD lab - Computer Science Department (DCC) - University of Chile
participants (3)
-
Johan Fabry -
Sabine Knöfel -
Stéphane Ducasse