dandyc / spree-guides

Official Spree Documentaion

SUMMARY

This project serves as the basis for the online documentation effort for the Spree ecommerce project. The documentation has been graciously donated by members of our online community. This work is licensed under the Creative Commons Attribution-Share Alike 3.0 license. Contributions are encouraged. Please ask Sean Schofield for commit access if you have something to contribute. If you are thinking about a new guide or major changes to the organization of the existing guides, please be courteous and do this in your own fork so it can be dicussed before merging.

Please stick to the established format and feel free to ask questions on spree-user or #spree if you have any questions.

To build the entire set of guides simply run the following command

  $ git clone git://github.com/spree/spree-guides.git
  $ cd spree-guides
  $ bundle install
  $ bundle exec guides build

You can force a rebuild of all of the guides using

$ bundle exec guides build --clean

You can also specify that you want to rebuild just a few of the guides

$ bundle exec guides build --only=checkout adjustments

To build edge guides including GA trakcking

$ bundle exec guides build --clean --edge --ga

Finally, you can also preview the guides while you work

$ bundle exec guides preview

If you'd like to make an ocassional contribution to the spree-guides project please fork it and send a pull request when you have changes that you'd like to be pulled into the master branch.

When you feel it is time to become a regular contributer feel free to send an email to spree-user (be sure to include your github username) and say that you would like to contribute. We'll add you to the list so you can commit directly to the guides project.

Please be considerate when making changes to the spree-guides. If you wish to make major changes to how the documentation is organized then you should use a GitHub fork and ask people to review your proposed changes instead.

Deploying

To deploy the normal guides:

$ cap deploy

To deploy edge guides:

$ cap deploy -S edge=true