ravendb / book Goto Github PK
View Code? Open in Web Editor NEWRavenDB Book
RavenDB Book
Hello,
I'm not sure if this is the right place to express my opinion
I think that this statement in the chapter 3 is "half wrong".
"A common bad practice is to integrate between different applications using a shared database."
The readers might understand that sharing database between applications is always a bad practices... and it is not true..
IMO, the Application A can make choice
it is comparable to make decision at the document-level: if a document will reference to other documents by de-normalization, or by reference id.. Both approaches have its pros and cons depend on the use cases (or context).
I agree with the bad side about sharing database described in the chapter. But for example:
A database which contains references data (common data) is absolutely valid to share among applications.
Running build.ps1 on Win 10, I get:
xelatex not found. Please select a different --pdf-engine or install xelatex
Start-Process: C:\src\Playground\ravendb\book\build.ps1:22
Line |
22 | start $output
| ~~~~~~~~~~~~~
| This command cannot be run due to the error: The system cannot find the file specified.
.\Output\Inside RavenDB 4.0.pdf
I googled installation of xelatex, and it said to install MikTeX, but i have this installed already. Please add a paragraph to the ReadMe to explain the prerequisites.
Also, is there a book forthcoming on RavenDb 5?
After switching to pdflatex instead of xelatex, in build.ps1 I am getting another error:
Error producing PDF.
! Package inputenc Error: Invalid UTF-8 byte sequence.
See the inputenc package documentation for explanation.
Type H <return> for immediate help.
...
l.15435 \passthrough{\lstinline!Martín Sommer!}
Try running pandoc with --pdf-engine=xelatex.
Start-Process: D:\src\Playground\ravendb\book\build.ps1:22
Line |
22 | start $output
| ~~~~~~~~~~~~~
| This command cannot be run due to the error: The system cannot find the file specified.
.\Output\Inside RavenDB 4.0.pdf
I am sorry, but I don't have time to become an expert in LaTeX just to get a PDF copy of the (as it appears, outdated) book produced.
Which is a copy/pasted caption from Listing 4.6
Part III simply reads "Modeling".
I get this error building (see input.log).
Urls and Database appears to be have renamed to Url and DefaultDatabase.
Is this type of proofreading even useful for you? I'm working through the examples and would report problems here - but if I just annoy you, it's no problem to stop it.
Hi,
I'm interested in contributing for this project and I'd like to be of help in translating this into the Filipino language. I think it'll be helpful for this to have a wider reach. Hope you'll consider.
Thanks :)
This is currently blank.
Part II simply reads "Indexing."
My version: 8. july 2018
p. 89 - see example in listing 3.8 (should be listing 3.7)
Well... not an issue but just an idea to help the lazy developers: have the resulting files available for download directly in the releases tab. :-)
The Listing instructs to use the Package Manager console, but Linux and MacOs don't have Visual Studio.
The dotnet command line should be able to fetch the package, too - but the syntax differs. Especially -IncludePreRelease does not exist.
Intro.md
Introduction
Sentence:
Working with a database be easy and obvious, and to a large extent, RavenDB allows that.
Maybe:
Working with a database should be easy and obvious, and to a large extent, RavenDB allows that.
Part IV simply reads "Operations."
In Ch01, you mention that RavenDB is an ACID database.
I'm tempted to correct this to "ACID-compliant" because it adheres to the rules/guidelines of ACID, but I'm not sure how you feel about that language.
Thoguhts?
The book is very interesting, I'd like to report some issues in the output formats though.
The default pdf format cannot easily be read on mobile devices, there's just too much margin and the font is just to small to be read easily. Sure you can zoom in but usually switching pages requires zooming out again, which makes for a poor read experience.
Exporting in epub format works but there seem to be issues in the validity of the resulting output, for example Google Books cannot import it, and desktop readers (Readium) have issues as well, especially with code fragments.
I tried to use your docker example from page 17 and encountered several issues:
After a lot of try and error (why does the python client not connect? Http works fine!) I digged into the Urls, Python barfed up and discovered that http://nbsauerch03:8080/topology?name=SomeDb
returned results such as:
{
"Nodes": [
{
"Url": "http://<containerid>:8080",
"ClusterTag": "A",
"ServerRole": "Member",
"Database": "SomeDb"
}
],
"Etag": -1
}
which does not work when seen from an external client - e.g. if I use the standard Docker-MobyLinux on Windows configuration. The Python Client then uses this Urls to try to get more Information, but fails with a TopologyException since the URL cannot be resolved.
Setting PUBLIC_SERVER_URL=http://localhost:8080 fixes that, but I#m unsure if I have to set other values, too.
Intro.md
Inrtoduction, line 23, word 16
just drop ACID behavioor
should be
just drop ACID behaviour
After manually adding the path to xelatex (which I found in %localappdata%\Programs\MiKTeX\miktex\bin\x64
and editied the build.ps1 script accordingly), I am getting more errors:
Error producing PDF.
! Argument of \__sys_tmp:w has an extra }.
<inserted text>
\par
l.80 ...c__kernel_sys_dvipdfmx_version_int { 0 } }
Start-Process: D:\src\Playground\ravendb\book\build.ps1:22
Line |
22 | start $output
| ~~~~~~~~~~~~~
| This command cannot be run due to the error: The system cannot find the file specified.
I must say, this is frustrating as hell. Someone please just provide a pdf, preferably of version 5.
Correct me if I'm wrong but I think there is an extra 'the' in this sentence.
Such
databases are very useful when one of the most important aspects of the data
isn’tthejust the data itself, but the association between different pieces of
information.
When copy-pasting code from the PDF, most examples are broken.
For example Listing 2.4 becomes this:
var s t o r e = new DocumentStore
{
Urls = { ” http :// l o c a l h o s t :8080” } ,
Database = ” Tasks ”
} ;
s t o r e . I n i t i a l i z e ( ) ;
Part IV simply reads "Scale out".
When I was rereading the newest version of your book on christmas, I was wondering if attachments are BASE or ACID - e.g. when is the document considered "complete" on the server?
When the json is saved on disk or if the json and all attachments are on disk?
If the first, this would be good to know since there might be situations where a document without attachment is not really usable.
I'm following the subscription example in Listing 5.5 https://github.com/ravendb/book/blob/v4.0/Ch05/Ch05.md#the-subscription-script
await subscription.Run(batch =>
{
foreach (var item in batch.Items)
{
SupportCall call = item.Document;
var age = DateTime.Today - call.Started;
if (age > DateTime.FromDays(14))
return; // no need to send survey for old stuff
using (var session = batch.OpenSession())
{
var customer = session.Load<Customer>(
call.CustomerId);
call.Survey = true;
session.Store(call, item.ChangeVector, item.Id);
try
{
session.SaveChanges();
}
catch (ConcurrenyException)
{
// will be retried by the subscription
return;
}
SendSurveyEmailTo(customer, call);
}
}
});
I think the use of return
is slightly misleading in here. Since the example uses foreach
using return
will actually skip processing the rest of the batch. It's probably more correct to either use continue
or batch.Items.ForEach(() => { ... return
Also I think the example would be more clear to state // will be retried in the next batch
and expand in the following paragraph that a ConcurrencyException
implies the document has changed on the server in between assembling the current subscription batch and saving the modification, which will in turn lead to the updated document to be included in a future subscription batch.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.