From 12908a8b1a72081d826481d1f8a2d2eca0f8dfdd Mon Sep 17 00:00:00 2001 From: Robert Hafner Date: Sat, 17 May 2014 01:20:26 -0700 Subject: [PATCH] Moved autoloader to overview, tweaked composer --- Basics.rst | 11 ----------- Overview.rst | 42 +++++++++++++++++++++++------------------- 2 files changed, 23 insertions(+), 30 deletions(-) diff --git a/Basics.rst b/Basics.rst index 41b536b..d041910 100644 --- a/Basics.rst +++ b/Basics.rst @@ -4,17 +4,6 @@ Basic Usage =========================== -Stash is a simple to use library with powerful features. - -Autoloading -=========== - -The Stash library conforms to the PSR-0 autoloading standard. If your project -doesn't already use a PSR-0 compliant autoloader, you can simply include the -`autoload.php` file at the root of the project to load Stash classes. - -All of Stash's classes live in the Stash namespace. - Creating Stash Objects ====================== diff --git a/Overview.rst b/Overview.rst index d249afc..081cfe5 100644 --- a/Overview.rst +++ b/Overview.rst @@ -17,36 +17,26 @@ Installation Composer -------- -For most projects Composer is the ideal method of installation. Stash is present +Composer is the preferred method of installation. Stash is present on `Packagist `_, making installation as easy as adding a directive to your project's composer.json file. -The simpliest way to use Composer is to include the latest version of Stash. +Until Stash reaches a stable API with version 1.0 it is recommended that you +review changes before even Minor updates, although bug fixes will always be +backwards compatible. -.. code-block:: none - - "require": { - "tedivm/stash": "*" - } - - -The downside to this is that API changes can occur which will break the project. -Composer allows specific versions or lines of development to be used. This -example, which is the preferred method, installs the latest version of the v0.10 -line of development, allowing for the latest enhancements but without the need -to worry about backwards compatibility breaking changes occurring. - -.. code-block:: none +.. code-block:: yaml "require": { "tedivm/stash": "0.12.*" } + For project looking to take advantage of the latest features it's also possible to install directly against the main development line. This is ideal for testing, but should be limited to non-production code. -.. code-block:: none +.. code-block:: yaml "require": { "tedivm/stash": "dev-master" @@ -59,8 +49,22 @@ website at http://getcomposer.org/. Direct Download --------------- -Releases of Stash are available for direct download on `Github -`_. +Versions of Stash are available as `Releases `_. +on Github. + + +Autoloading +=========== + +If you installed using composer then you simply need to include it's autoloader. +This is the preferred method of loading Stash. + +Stash confirms to PSR-0 and places it's code in the src folder, making it easy +to include in a custom autoloader. This means "Stash\Pool" can be found in +"src\Stash\Pool.php".. + +If all else fails there is an autoloader that is packaged with Stash itself. +Just include "autoload.php". License