Fair comments. The real issue (in my mind) is how much Python and Django experience can we reasonably expect people to have before they start trying to get Satchmo working.
For example, your comment about site-packages as being /usr/lib/python2.5/site-packages on your distro is correct. However, it's not always going to be that on every distro and it's definitely not the same on Windows (and probably not Mac). What can we put in here to be clear but not have a ton of "or" statements? My philosophy is that Satchmo is for someone that needs to customize a store. If all you need is a simple store that only sells 2 products, then you're probably going to be happier with some sort of hosted solution. However, if you have unique needs, there's almost no getting around the fact that you will need to do some coding and you will need to understand how Django and Python work. Don't let my comments discourage anyone from making the documenation cleaner but IMHO the documentation gaps are much bigger when we talk about doing really cool customizations than in getting the install working. I realize that last sentence will bug some people. Especially those struggling to get it installed. However, installation is generally something you get done once and it's pretty trivial to do again. Yeah, it can suck in the process but once you know how to do it for Django, Satchmo isn't that unique in the install process. The nature of Django and Python don't always lend itself to a cookbook installation approach. Lastly, as far as a demo project - you can see one version here - http://demo.satchmoproject.com/store/ Also, if you have trunk, cd into /satchmo/projects/simple and type python manage.py runserver You'll then have a full demo system up and running including the admin. -Chris On Sat, Jan 10, 2009 at 12:47 PM, Freyr <[email protected]> wrote: > > Few comments from the newbie: > > 1) I have a pair of fresh eyes. Either it is those two or my > misunderstanding but. To a new user like me the following line without > explanation does not fully explain it self: > > cd /path/to/your/site-packages/dir > > I'd add (e.g. cd /usr/lib/python2.5/site-packages/) > > (Unless that was my misunderstanding :)) > > 2) I also find the .pth method (described well by Dan in his post) > cleaner than the ln > (This is very much a matter of taste I believe) > > 3) To be picky I'd capitalize satchmo in "The easiest way to install > satchmo requirements" > > 4) I did not see "easy_install > http://tinyforge.org/frs/download.php/1/trml2pdf.tar.gz"; > be working. I had to manually download and install from there. > > 5) While "Copy the rest of the required files" section is not working, > it needs to be replaced somehow. > > 6) You do often use "sudo some_command something" where sudo is only > used in some distros (and e.g. not on Windows) > > Well... I hope this Satchmo system will be nice when I finally see it > running :) > And one additional comment, would it be possible to have somewhere a > demo site running. Where you can log in, to see how this looks like. > > Now I've spent (too many) hours getting this system to work and still > I've not even had a glimpse to see what it looks like. > > Take care, > > Freyr > > On Jan 10, 6:25 pm, "Chris Moffitt" <[email protected]> wrote: > > I just added some updated docs based on the various feedback from the > group. > > > > http://www.satchmoproject.com/docs/svn/new_installation.html > > > > Let me know if you have any ideas on how to clarify or make it better. > > -Chris > > > > > > > > On Sat, Jan 10, 2009 at 12:07 PM, Dan Harris <[email protected]> wrote: > > > > > I would be willing to help out on updating the documentation, let me > > > know what is needed and i'll see what I can do. > > > > > On Jan 8, 10:56 pm, "Shankar Dhanasekaran" <[email protected]> > > > wrote: > > > > Thank you Steve for your feedback. I will add 'signals' to the doc. > > > Please > > > > can you clarify this in a more detail way on what you actually like > to > > > see, > > > > probably with an example. I appreciate that greatly. > > > > > > > "how the general users moves through the site and how it relates > to > > > the > > > > > underlying views, modules, etc... " > > > > > > Thanks, > > > > Shakthi > > > > > > On Fri, Jan 9, 2009 at 6:41 AM, Steve Potter < > [email protected] > > > >wrote: > > > > > > > On Jan 8, 4:58 pm, "Chris Moffitt" <[email protected]> wrote: > > > > > > Shakthi, > > > > > > > > I like the layout you propose for the documentation. In order to > make > > > it > > > > > a > > > > > > bit easier for others to view and comment on the layout, I've > added a > > > > > page > > > > > > to the wiki - > > > > >http://www.satchmoproject.com/trac/wiki/DocumentationReorganization > > > > > > > > I encourage folks to take a look at the page and give feedback on > the > > > > > > proposed layout. > > > > > > > > -Chris > > > > > > > > On Thu, Jan 8, 2009 at 1:30 PM, Shankar Dhanasekaran < > > > > > > > > [email protected]> wrote: > > > > > > > Thank you Chris for your support. > > > > > > > I am attaching a text file containing the outline for the > proposed > > > > > > > documentation. I invite everyone to glance the text file and > add > > > your > > > > > > > generous comments and valuable suggestions. > > > > > > > > > I am on irc on my nickname shakthi and my skype is > ikeeponloving. > > > > > Chris, > > > > > > > let me know when you are free to chat on irc or on skype. We > need > > > to > > > > > have > > > > > > > online calender (or something similar) to fillout who is > available > > > and > > > > > what > > > > > > > time to coordinate discussions. This will be greatly helpful to > > > work in > > > > > > > different timezones and also each one of us who is willing to > work > > > in > > > > > the > > > > > > > documentation can choose the topic and time to chat. > > > > > > > > > Looking forward to hear from more of you. (Bruce, John, Brian > et al > > > are > > > > > you > > > > > > > there?) > > > > > > > > > Thank you, > > > > > > > Shakthi > > > > > > > > > ----- Original Message ----- > > > > > > > From: "Chris Moffitt" <[email protected]> > > > > > > > To: [email protected] > > > > > > > Sent: Thursday, January 8, 2009 7:43:31 PM GMT +05:30 Chennai, > > > Kolkata, > > > > > > > Mumbai, New Delhi > > > > > > > Subject: Re: Proposal for Documentation Help > > > > > > > > > Well, I'm the first to admit that the documentation needs some > > > help. > > > > > I'm > > > > > > > willing to do what I can to provide some direction and support. > If > > > we > > > > > can > > > > > > > get a few people online at once, maybe we can do some sort of > > > sprint > > > > > via IRC > > > > > > > or something. Either way, I will try and help as much as time > > > permits. > > > > > > > > > -Chris > > > > > > > > > On Thu, Jan 8, 2009 at 6:26 AM, Shankar Dhanasekaran < > > > > > > > [email protected] > wrote: > > > > > > > > > Thank you for the reply. Let's wait for more response and reply > > > from > > > > > the > > > > > > > core developers if they will be happy to help this initiative. > > > > > > > > > regards, > > > > > > > shakthi > > > > > > > > > On Thu, 2009-01-08 at 03:12 -0800, phoenix24 wrote: > > > > > > > > that's definitely a good idea, i'll be glad to help out! > > > > > > > > > > On Jan 8, 2:10 pm, Shankar Dhanasekaran < > > > [email protected] > > > > > > > > > wrote: > > > > > > > > > Hello All, > > > > > > > > > This is a small proposal to enhance the documentation of > > > Satchmo. > > > > > > > > > About me: > > > > > > > > > I am Shankar Dhanasekaran from India and you might seen me > on > > > this > > > > > > > group > > > > > > > > > a couple of times under my penname shakthi. I am not an > expert > > > at > > > > > > > either > > > > > > > > > django or satchmo but am no novice either. I have been > working > > > both > > > > > > > > > these for many months now reading django docs in and out. > > > > > > > > > > > I am also working on my own e-commerce store for which I am > > > using > > > > > > > > > Satchmo. > > > > > > > > > > > Proposal: > > > > > > > > > I like django documentation (everyone likes!) and I wish > with > > > the > > > > > > > > > cooperation from the satchmo team the same kind of > > > documentation > > > > > can be > > > > > > > > > brought out for satchmo. I am willing to dedicate an hour > or > > > two, > > > > > daily > > > > > > > > > or once two days for this. But I cannot do this all alone > as my > > > > > > > > > knowledge about satchmo is very less. If the experts at > satchmo > > > can > > > > > > > > > spend a few min on skype to speak about the code and give > me a > > > > > rough > > > > > > > > > idea, I will do transcription of the talk and also write my > own > > > > > docs if > > > > > > > > > the experts give me some starting tips. > > > > > > > > > > > I hope this reaches all satchmo well wishers and invite > > > everyone to > > > > > > > > > share their thought on this. > > > > > > > > > > > Thanks, > > > > > > > > > Shakthi > > > > > > > In general I like the layout. I would like to see somewhere (Maybe > > > > > under beyond the basics, or the developers section) an explanation > of > > > > > how the general users moves through the site and how it relates to > the > > > > > underlying views, modules, etc... Also if some information could > be > > > > > integrated about what signals are triggered and when, that would be > > > > > great. > > > > > > > Steve > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Satchmo users" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/satchmo-users?hl=en -~----------~----~----~----~------~----~------~--~---
