update examples and doc

Author: 7bitcoder

Docs/advanced-guides/building-library.rst

@@ -1,31 +1,76 @@
-Building Library
+Build Library
 ==========================
 
-The library can be built locally using Cmake_ (`Cmake Installation`_), and several cache variables can be set:
+The library can be built locally using Cmake_ (`Cmake Installation`_)
+
+Create build directory and navigate to it:
+
+.. code-block:: sh
+
+    mkdir build && cd build
+
+Configure cmake project
+
+.. code-block:: sh
+
+    cmake .. -DCMAKE_BUILD_TYPE=Debug
+
+Using this command several cache variables can be set:
 
 * <variable cache name>: [possible values] (default value) - Description
 * LIBRARY_TYPE: ["Shared", "Static", "HeaderOnly"] ("HeaderOnly") - Library build type
 * BUILD_DOCS: [true, false] (false) - Turn on to build documentation (requires Sphinx_, Breathe_ and Doxygen_ installed)
-* BUILD_TESTS: [true, false] (false) - Turn on to build tests (requires Gtest_ to be installed, see `Conan Packages Installation`_)
+* BUILD_TESTS: [true, false] (false) - Turn on to build tests (requires Gtest_ to be installed, see `Build Library With Conan`_)
 * BUILD_EXAMPLES: [true, false] (false) - Turn on to build examples
 
-build the library using the command:
+to set cache variable pass additional option: -D<variable cache name>=[value] 
+for example this command will set library type to Static and will force examples built
 
 .. code-block:: sh
 
-    cmake --build ./build
+    cmake .. -DCMAKE_BUILD_TYPE=Release -DLIBRARY_TYPE=Static -DBUILD_EXAMPLES=true
+
+Build the library using the command:
+
+.. code-block:: sh
 
+    cmake --build .
 
-Conan Packages Installation
+
+Build Library With Conan
 ^^^^^^^^^^^^^^^
 
 Gtest_ library is added to project using Conan_ package manager (`Conan Installation`_), 
-to install Conan packages run this command in the library root folder:
+If conan was fresh installed run detect command:
+
+.. code-block:: sh
+
+    conan profile detect
+
+To install Conan packages run this command in the library root folder:
 
 .. code-block:: sh
 
     conan install . --output-folder=build --build=missing
 
+Navigate to build directory:
+
+.. code-block:: sh
+
+    cd build
+
+Configure cmake project, add also toolchain file as a CMAKE_TOOLCHAIN_FILE cache variable:
+
+.. code-block:: sh
+
+    cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=true -DCMAKE_TOOLCHAIN_FILE:STRING="conan_toolchain.cmake"
+
+Build the library using the command:
+
+.. code-block:: sh
+
+    cmake --build .
+
 .. _Cmake: https://cmake.org/
 .. _`Cmake Installation`: https://cmake.org/download/
 .. _Sphinx: https://www.sphinx-doc.org/en/master/

Docs/advanced-guides/external-singleton.rst

@@ -3,8 +3,8 @@ External Singleton
 
 Singleton can be registered externally
 
-.. literalinclude:: ../../Examples/ExternalSingleton.cpp
-   :caption: Examples/ExternalSingleton
+.. literalinclude:: ../../Examples/Guides/ExternalSingleton.cpp
+   :caption: Examples/Guides/ExternalSingleton
    :language: C++
 
 .. code-block:: console

Docs/advanced-guides/using-factories.rst

@@ -1,11 +1,12 @@
 Using Factories
 ========================================
 
-Factory functor can be provided to manually create a service. Functor should return unique_ptr and as an argument should optionally take reference to the service provider.
+Factory functor can be provided to manually create a service. 
+Functor should return unique_ptr and as an argument should optionally take reference to the service provider.
 Functor scheme (IServiceProvider &) -> std::unique_ptr or () -> std::unique_ptr
 
-.. literalinclude:: ../../Examples/FactoryFunctions.cpp
-   :caption: Examples/FactoryFunctions
+.. literalinclude:: ../../Examples/Guides/FactoryFunctions.cpp
+   :caption: Examples/Guides/FactoryFunctions
    :language: C++
 
 .. code-block:: console

Docs/basic-guides/core-classes.rst

@@ -9,6 +9,6 @@ The library relies on two core classes:
 .. _ServiceCollection: ../reference/di/servicecollection.html
 .. _IServiceProvider: ../reference/di/iserviceprovider.html
 
-.. literalinclude:: ../../Examples/CoreClasses.cpp
-   :caption: Examples/Basic
+.. literalinclude:: ../../Examples/Guides/CoreClasses.cpp
+   :caption: Examples/Guides/Basic
    :language: C++

Docs/basic-guides/injecting-multiple-services.rst

@@ -14,8 +14,8 @@ Multiple services can inherit one interface and can be injected using a vector.
    * Transient services should be injected using std::vector<std::unique_ptr> 
 
 
-.. literalinclude:: ../../Examples/InjectingMultipleServices.cpp
-   :caption: Examples/InjectingMultipleServices
+.. literalinclude:: ../../Examples/Guides/InjectingMultipleServices.cpp
+   :caption: Examples/Guides/InjectingMultipleServices
    :language: C++
 
 .. code-block:: console

Docs/basic-guides/injecting-service-provider.rst

@@ -3,8 +3,8 @@ Injecting Service Provider
 
 Service Provider object can be injected and can be used to manually get (scoped/singletons) or create (transient) services.
 
-.. literalinclude:: ../../Examples/InjectingServiceProvider.cpp
-   :caption: Examples/InjectingServiceProvider
+.. literalinclude:: ../../Examples/Guides/InjectingServiceProvider.cpp
+   :caption: Examples/Guides/InjectingServiceProvider
    :language: C++
 
 .. code-block:: console

Docs/basic-guides/injecting-services.rst

@@ -11,8 +11,8 @@ This example shows the main purpose of this library, injecting services into ser
    * Singleton/scoped service should be injected using pointners (references are not allowed due to library limitations, it might be fixed in the future) 
    * Transient services should be injected using std::unique_ptr 
 
-.. literalinclude:: ../../Examples/InjectingServices.cpp
-   :caption: Examples/InjectingServices
+.. literalinclude:: ../../Examples/Guides/InjectingServices.cpp
+   :caption: Examples/Guides/InjectingServices
    :language: C++
 
 .. code-block:: console

Docs/basic-guides/injection-rules.rst

@@ -26,8 +26,8 @@ Injecting Services
   * Transient (std::vector<std::unique_ptr<T>>)
   * Singleton/scoped (std::vector<T*>)
 
-.. literalinclude:: ../../Examples/InjectionRules.cpp
-   :caption: Examples/InjectionRules
+.. literalinclude:: ../../Examples/Guides/InjectionRules.cpp
+   :caption: Examples/Guides/InjectionRules
    :language: C++
 
 

Docs/basic-guides/separate-implementation.rst

@@ -4,8 +4,8 @@ Separate Implementation
 This example shows how to register the service as an interface with implementation.
 Service will be accessible only by an interface, implementation is hidden for the client 
 
-.. literalinclude:: ../../Examples/SeparateImplementation.cpp
-   :caption: Examples/SeparateImplementation
+.. literalinclude:: ../../Examples/Guides/SeparateImplementation.cpp
+   :caption: Examples/Guides/SeparateImplementation
    :language: C++
 
 .. code-block:: console

Docs/basic-guides/services-lifetime.rst

@@ -20,8 +20,8 @@ Service can be registered as singleton, scoped or transient.
 
    Only singleton/scoped services can be accessed using the getService method otherwise the method will throw an exception 
 
-.. literalinclude:: ../../Examples/ServicesLifeTime.cpp
-   :caption: Examples/ServicesLifeTime
+.. literalinclude:: ../../Examples/Guides/ServicesLifeTime.cpp
+   :caption: Examples/Guides/ServicesLifeTime
    :language: C++
 
 .. code-block:: console