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/lastSuccessfulBuild/artifact/Voyage/Voyage.pier.html and https://github.com/SquareBracketAssociates/PharoForTheEnterprise-english/tree/master/Voyage 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 [hidden email]
To unsubscribe from Pharo Smalltalk Users, click here.
NAML

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]> 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-td4704104.html#a4704127
>
> 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.html

To start a new topic under Pharo Smalltalk Users, email [hidden email]
To unsubscribe from Pharo Smalltalk Users, click here.
NAML