[Cubicweb] A newbie on Windows - installation pitfalls
stefan.pankoke at googlemail.com
Fri Sep 10 20:55:29 CEST 2010
seems like this is the right place for low-profile hackers like me...
Thanks for all the feedback. Yes, the docs read much better now.
However, as a nitpicker I'd like to make some more comments.
1. "thusly", somewhere in 22.214.171.124: there is no such word in English.
Replace with "as follows".
2. 1.1.5: Windows installation: There is a tools section explaining how
to install mercurial. This is not good here as Mercurial makes perfect
sense on all OS's. So move it out of the Windows section. I would
suggest to regroup the whole thing a bit starting with a general section
on what you must have:
- dependencies including a database, maybe sqlite etc..,
- the sources (however you get them)
and the nice-to-have's:
The windows section then comes down to a link collection to Windows
installers. Well, feel free to regard the above as bullshit, but it
makes sense to me right now.
3. On databases: the section on sqlite is not self-explanatory. Can I
suggest to add a general subsection on databases that explains when and
how to select the database?
4. Which dependencies? Under 1.1.3 the docs refer to some appendices
(mind the plural!). Well, I haven't seen them as it appears the
dependencies are well explained in the chapter. If there are really
appendices, a hyperlink would seem in order under 1.1.3.
But now I shut up to try and go through all these steps myself. It's
time to have CW up and running here...
Am 09.09.2010 10:23, schrieb Sylvain Thénault:
> On 08 septembre 10:42, Nicolas Chauvat wrote:
>>> 3. Choosing the database
>> Would you consider these issues fixed? Please comment further if needed.
>> PS: see the diff at http://hg.logilab.org/cubicweb/rev/80388edf4e88
> IMO one thing we should make easier and clearer in the doc is the
> usage of sqlite as database, so one can give a try without having
> to install postgres or so.
> It works fairly well, the only point being that you currently either
> have to change c-c create input level so it ask which database driver
> to use, or you have to interrupt the creation process to change it
> in the instance'source file. I guess we should lower the input level
> of the database driver option. Then update the book/quickstart.
More information about the Cubicweb