diff --git a/src/docbkx/index.xml b/src/docbkx/index.xml index 3828ec44a..177f991e0 100644 --- a/src/docbkx/index.xml +++ b/src/docbkx/index.xml @@ -3,7 +3,8 @@ - The Spring Data Graph Guidebook + Good Relationships + The Spring Data Graph Guidebook &version; @@ -25,6 +26,13 @@ + + + + + + + Copies of this document may be made for your own use and for distribution @@ -52,12 +60,33 @@ - About this book + About this Guide Book - Duplex book -> Fowler bliki - - 1. Narrative / Tutorial - 2. Reference docs + Welcome to the Spring Data Graph Guide Book. Thank you for taking the time to get an in depth look into the + usage and workings of the Spring Data Graph Library. Spring Data Graph is part of the Spring Data project which + aims to provide the convenient programming model of the Spring Framework to the big field modern datastores + (mostly NoSQL). Spring Data Graph in particular currently provides integration for the Neo4j Graph Database. + + It was written by developers for developers. So hopefully we created a documentation that is well received by + our peers. + + If you have any feedback to the Spring Data Graph Library or this book, please provide it via SpringSource JIRA, + the SpringSource NoSQL Forum, github comments or issues or the Neo4j mailing list. + + This book is presented as a duplex book, a term coined by Martin Fowler. A duplex book consists of at least two + parts. The first part is an easily accessible narrative, that gives the reader an overview of the topics contained + in the book. It contains lots of examples and more general discussion topics. This should be the only part of + the book that is required to be read cover-to-cover. + + We chose a tutorial describing the creation of a web applicaton (cineasts.net) that allows movie enthusiasts to + find the favorites, rate them, connect with each other and enjoy social features. The application is running on + Neo4j using Spring Data Graph and the well known Spring Web Stack. + + The second part is the classic reference documentation containing the detailed information about the library. + It discusses the programming model, the underlying assumptions, used toolset (like aspectj) as well as the APIs + for the object-graph mapping and the template approach. The reference docs should be mainly used to look up + concrete bits of information or to dig deeper into certain topics. @@ -65,7 +94,14 @@ Tutorial - Tutorial intro ... + In this first part of the book we run a tutorial that creates a complete web application built on top of Spring Data Graph. + It uses a domain that should be familiar to most - movies. So for cineasts.net we decided to add a social + touch to the whole movie rating business, allowing friends to share their ratings and get recommendations + for new friends and movies. + + The tutorial is presented as a colloquial description of the steps necessary to create the application. + It provides the configuration and code examples that are needed to understand what's happening. The complete + source code repository for running the app is available on github. diff --git a/src/docbkx/resources/images/cineasts_actor.png b/src/docbkx/resources/images/cineasts_actor.png new file mode 100644 index 000000000..dfa026eb3 Binary files /dev/null and b/src/docbkx/resources/images/cineasts_actor.png differ diff --git a/src/docbkx/resources/images/cineasts_main.png b/src/docbkx/resources/images/cineasts_main.png new file mode 100644 index 000000000..13f3950be Binary files /dev/null and b/src/docbkx/resources/images/cineasts_main.png differ diff --git a/src/docbkx/resources/images/cineasts_movie.png b/src/docbkx/resources/images/cineasts_movie.png new file mode 100644 index 000000000..7a87e6677 Binary files /dev/null and b/src/docbkx/resources/images/cineasts_movie.png differ diff --git a/src/docbkx/resources/images/cineasts_results.png b/src/docbkx/resources/images/cineasts_results.png new file mode 100644 index 000000000..7e1975da7 Binary files /dev/null and b/src/docbkx/resources/images/cineasts_results.png differ diff --git a/src/docbkx/resources/images/cineasts_user.png b/src/docbkx/resources/images/cineasts_user.png new file mode 100644 index 000000000..e281a9cd7 Binary files /dev/null and b/src/docbkx/resources/images/cineasts_user.png differ diff --git a/src/docbkx/tutorial/about-tutorial.xml b/src/docbkx/tutorial/about-tutorial.xml index 482258a8a..98e69c616 100644 --- a/src/docbkx/tutorial/about-tutorial.xml +++ b/src/docbkx/tutorial/about-tutorial.xml @@ -4,7 +4,7 @@ Allow me to introduce - Cineasts.net Once upon a time I wanted to build a social movie database myself. First things first - I had a name: "Cineasts" - the people -crazy about movies. So I went ahead and bought the domain, cineasts.net. So, the project was almost done. +crazy about movies. So I went ahead and got the domain, cineasts.net. So, the project was almost done. I had some ideas as well. Of course there should be Actors who play Roles in Movies. I needed the Cineast, too, someone had to rate the movies after all. And while they were there, they could also make friends. Find someone to accompany them to the cinema or share @@ -16,9 +16,16 @@ existing friends. -I looked for possible sources for data, IMDB was my first stop, but they charge 15k for data usage. Fortunately I found themoviedb.org which has -liberal terms and conditions and a nice API for fetching the data. +I looked for possible sources for data, IMDB was my first stop, but they charge 15k USD for data usage. Fortunately I found TheMoviedb.org which has + built its data independently by users and provides the data for free for any usecase. The also have liberal terms and conditions and a nice API for fetching the data. -There were many more ideas but I wanted to get something done over the course of one day. So this was the scope I was going to tackle. * What is Cineasts.net +There were many more ideas but I wanted to get something done over the course of one day. So this was the scope I was going to tackle. And this is how it should look + like. + + + + + +