Sorry for dusting off this old message, but has anything ever been done about this 'end-user' documentation?
On Wednesday, 23 September 2009 10:08:31 UTC-4, Chris Moffitt wrote: > > The more I think about this, the more I think it would be good to have a > section of the docs that is tailored towards the end user of the shop. > > Thoughts, ideas, patches and contribs are helpful ;) > > -Chris > > On Wed, Sep 23, 2009 at 2:42 AM, Simon <[email protected]> wrote: > >> 2009/9/21 Lee Packham <[email protected]> >> >> >>> Addendum - I'm blind - the dependency is there - sowwy! The man still >>> speaks sense though. >>> >> >> The man does speak sense. But I would say Satchmo has three target >> audiences. >> Below I will list them and what I think we need to provide them. >> >> *Store holders* >> >> - A sexy demo store to help sway their decision. >> - Improved admin interface. >> - Documentation. >> >> *Store developers* >> This kettle of fish may not know or want to touch Satchmo code base. To >> get a store up and running >> they just want to change a few settings and templates. As Python gets >> more and more PHP converts >> this audience will increase. The other way of looking at it is the more >> we target them the more PHP >> converts Python will get. >> >> - Easy way to try out Satchmo. >> - A sexy demo store to help sway their decision. >> - Documentation. >> >> *Seasoned developers* >> Well that's us. The one's that extend Satchno to do funky things. We >> don't want the install script >> getting in our way. >> >> - Documentation. >> >> So what does this mean for the Documentation. Well basically it needs to >> target three audiences. Store >> holders want to know how to use the admin interface etc... This needs to >> be the easiest to find. Then the >> store developers want to know how to Install, customise (settings, >> templtes) and deploy. Then there >> are the seasoned developers but I think that runs on nicely from the >> store developers docs. >> >> Talking about the Docs in terms of verbosity is a bit abstract. I think >> the Docs need to be concise (brief in >> form but comprehensive in scope.) >> >> >> >> >> > On Wednesday, 23 September 2009 10:08:31 UTC-4, Chris Moffitt wrote: > > The more I think about this, the more I think it would be good to have a > section of the docs that is tailored towards the end user of the shop. > > Thoughts, ideas, patches and contribs are helpful ;) > > -Chris > > On Wed, Sep 23, 2009 at 2:42 AM, Simon <[email protected]> wrote: > >> 2009/9/21 Lee Packham <[email protected]> >> >> >>> Addendum - I'm blind - the dependency is there - sowwy! The man still >>> speaks sense though. >>> >> >> The man does speak sense. But I would say Satchmo has three target >> audiences. >> Below I will list them and what I think we need to provide them. >> >> *Store holders* >> >> - A sexy demo store to help sway their decision. >> - Improved admin interface. >> - Documentation. >> >> *Store developers* >> This kettle of fish may not know or want to touch Satchmo code base. To >> get a store up and running >> they just want to change a few settings and templates. As Python gets >> more and more PHP converts >> this audience will increase. The other way of looking at it is the more >> we target them the more PHP >> converts Python will get. >> >> - Easy way to try out Satchmo. >> - A sexy demo store to help sway their decision. >> - Documentation. >> >> *Seasoned developers* >> Well that's us. The one's that extend Satchno to do funky things. We >> don't want the install script >> getting in our way. >> >> - Documentation. >> >> So what does this mean for the Documentation. Well basically it needs to >> target three audiences. Store >> holders want to know how to use the admin interface etc... This needs to >> be the easiest to find. Then the >> store developers want to know how to Install, customise (settings, >> templtes) and deploy. Then there >> are the seasoned developers but I think that runs on nicely from the >> store developers docs. >> >> Talking about the Docs in terms of verbosity is a bit abstract. I think >> the Docs need to be concise (brief in >> form but comprehensive in scope.) >> >> >> >> >> > -- You received this message because you are subscribed to the Google Groups "Satchmo users" group. To view this discussion on the web visit https://groups.google.com/d/msg/satchmo-users/-/gKLKob3_Q-MJ. 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.
