Clean up temp notes

Author: einarf

docs/source/effects.rst

@@ -2,9 +2,13 @@
 Effects
 =======
 
-In order to draw something to the screen using this framework you need to make one or multiple effects.
-An effect is an independent python package of a certain format.
+In order to draw something to the screen using this framework you need to make one or
+multiple effects. what these effects are doing is entirely up to you. Some like to
+put everything into one effect and switch what they draw by flipping some internal
+states, but this is probably not practical for more complex things.
 
+An effect is a class with references to resources and a method for drawing.
+An effect is an independent python package of specific format.
 
 The Effect Package
 ^^^^^^^^^^^^^^^^^^
@@ -53,6 +57,10 @@ Resources
 Resource loading is baked into the effect class it self. Methods are inherited
 from the base ``Effect`` class such as ``get_shader`` and ``get_texture``.
 
+Remember that you can also create global resource directories for all
+the effects in your projects as well. This can be achieved by configuring
+resource finders in :doc:`settings`.
+
 The Effect Module
 ^^^^^^^^^^^^^^^^^
 

docs/source/tempnotes.rst

@@ -4,18 +4,12 @@ Temporary Notes
 
 This needs to be restructured into actual docs.
 
-- Shaders and textures can be easily loaded by using the ``get_texture`` and
-  ``get_shader`` method inherited from ``Effect``.
 - The ``cube`` objects is a ``VAO`` that you bind supplying the shader and the system
   will figure out the attribute mapping.
-- Please look in the ``demosys.opengl.geometry`` module for the valid attribute names and
-  look at shaders in the testdemo_.
 - You currently define vertex,
   fragment and geometry shader in one glsl file separated by
   preprocessors.
-- Effects not defined in the ``settings.py`` module will not run.
 
-That should give you an idea..
 
 Anything we draw to the screen must be implemented as an ``Effect``. If
 that effect is one or multiple things is entirely up to you. An effect
@@ -46,20 +40,6 @@ Some babble about the current state of the project:
   in a shader that only use position (or any other combination of attributes
   in the VAO); the VAO class will on-the-fly generate a version internally
   with only positions.
-- We only support 2D textures at the moment loaded with PIL/Pillow, but
-  this is trivial to extend.
-- Resource loading is supported in the ``Effect`` class itself. In ``__init__()``
-  you can fetch resources using for example ``self.get_shader`` or\ ``self.get_texture``.
-  This will return a lazy object that will be populated after the loading
-  stage is done.
-- Resources shared between effects can be put outside effect packages
-  inside your project directory. For example in ``testdemo/resources/shaders``
-  and ``testdemo/resources/textures``. Make sure you add those paths in the
-  settings file.
-- We don't have any scene/mesh loaders. You can hack something in yourself
-  for now or just stick to or extend the ``geometry`` module. - We try to
-  do as much validation as possible and give useful feedback when something
-  goes wrong.
 - The ``time`` value passed to the effects ``draw`` method is the current
   duration in the playing music. If no music is loaded, a dummy timer is used.