Merge pull request #3170 from Starbuck5/window-public-docs

Publicize window docs

Author: ankith26

docs/reST/index.rst

@@ -62,9 +62,6 @@ turn them to stable API in the future ^^.
 :doc:`ref/geometry`
   Pygame module for the Circle, Line, and Polygon objects.
 
-:doc:`ref/window`
-  Pygame object that handles a window.
-
 :doc:`ref/sdl2_controller`
   Pygame module to work with controllers.
 
@@ -244,6 +241,9 @@ Reference
 :doc:`ref/typing`
   Provide common typehints
 
+:doc:`ref/window`
+  Pygame object that handles a window.
+
 :doc:`pygame C API <c_api>`
   The C api shared amongst pygame extension modules.
 

docs/reST/ref/window.rst

@@ -10,10 +10,10 @@
    | :sl:`pygame object that represents a window`
    | :sg:`Window(title='pygame window', size=(640, 480), position=None, fullscreen=False, fullscreen_desktop=False, **kwargs) -> Window`
 
-   The Window class (formerly known as _sdl2.video.Window), is an experimental
-   feature of pygame-ce. This class allows for programs to drive multiple
-   Windows on-screen at once, something not possible with the
-   :func:`pygame.display.set_mode` API. Not everything possible with
+   The Window class (formerly known as _sdl2.video.Window), is a newly
+   published feature of pygame-ce 2.5.2. This class allows for programs
+   to drive multiple Windows on-screen at once, something not possible with
+   the :func:`pygame.display.set_mode` API. Not everything possible with
    :mod:`pygame.display` is possible yet in the Window API, but the new
    window class will continue to be developed, and we're excited to share
    the new functionality this class offers.

docs/reST/themes/classic/elements.html

@@ -41,7 +41,7 @@ <h5>pygame-ce documentation</h5>
 {%- set basic = ['Color', 'display', 'draw', 'event', 'font', 'image', 'key', 'locals', 'mixer', 'mouse', 'music', 'pygame', 'Rect', 'Surface', 'time'] %}
 {%- set experimental = ['sdl2_video', 'controller', 'geometry', 'Window'] %}
 {%- set advanced = ['BufferProxy', 'freetype', 'gfxdraw', 'midi', 'PixelArray', 'pixelcopy', 'sndarray', 'surfarray', 'cursors', 'joystick', 'mask', 'math', 'sprite', 'transform'] %}
-{%- set hidden = ['sdl2_video', 'geometry', 'Window'] %}
+{%- set hidden = ['sdl2_video', 'geometry'] %}
 {%-   if pyg_sections %}
 	  <p class="bottom"><b>Most useful stuff</b>:
 {%      set sep = joiner(" | \n") %}