Various doc improvements (#2335)

* Move how to get help into community

* Move games images + add local versions

* About + Community

* Solve duplicate links

Author: einarf

doc/_archive/index.rst

@@ -1,6 +1,6 @@
 :hide-toc:
 
-.. image:: images/arcade-logo.svg
+.. image:: images/logo/arcade-logo.svg
     :width: 10%
     :class: right-image
 

doc/about/intro.rst

@@ -2,12 +2,54 @@
 Introduction
 ============
 
-Start here
-----------
+Welcome to the official documentation of Arcade.
 
-Some Introduction
+Learning Resources
+------------------
+
+Arcade offers several resources to help you get started regardless of your
+experience level. People learn in different ways, so we try to offer a variety
+of resources to help you learn.
+
+* Examples
+* Tutorials
+* API Reference
+* Arcade Book
+* Skill Tree
 
 Community driven
 ----------------
 
-Created by the community. For the community.
+Arcade is a community driven project. We cannot exist without the help of our users.
+You don't need to be an experienced programmer or a game developer to help us.
+You can help us by reporting bugs, suggesting improvements, pointing out issues
+in documentation or even by sharing your projects with us.
+
+* More information about ways to contribute: :ref:`how-to-contribute`.
+* Also see :ref:`community-locations` for more information about where to find the
+  community.
+
+History
+-------
+
+The Python Arcade Library was created by Paul Vincent Craven. Paul was a professor
+of Computer Science at Simpson College in Iowa. He created the library
+to teach his students how to program games in Python. The first public pre-release
+was in March 2016.
+
+There is no question the focus of the library is on education. It's designed to
+be easy to use and to teach programming concepts.
+
+The library has grown since then and is now used by people all over the world.
+The library is mostly used in schools and by hobbyists, but have also been used in
+various other settings such as visualization, simulation and prototyping. As the
+library grows it's starting to be used in more professional settings as well.
+
+Notable Releases
+
+* First public pre-release in March 2016
+* First stable release 1.x in May November 2016
+* 2.0 release in 2019
+* 2.4 release in 2020
+* 2.6 release in 2021 through 2022
+* 3.0 release in 2024

doc/community/community_locations.rst

@@ -0,0 +1,21 @@
+.. include:: /links.rst
+
+.. _community-locations:
+
+Community Locations
+===================
+
+Most of the community interaction happens on the  `Arcade Discord`_ and `Arcade Github`_.
+The discord server is the best place to ask questions and get help.
+We have help channels, various topic channels, and a place to share
+your projects. This is also where most of the development discussion
+happens.
+
+Less active places (as of Summer 2024):
+
+* `Reddit`_
+* `Twitter`_
+
+Note that these communities have people of all ages from all around the
+world. Please be respectful and kind to everyone. Assume good intentions
+and be patient with people who are learning.

doc/games/game_jam_2020.rst renamed to doc/community/games/game_jam_2020.rst

@@ -5,7 +5,7 @@
 Python Discord GameJam 2020
 ===========================
 
-.. image:: images/game_jam_2020.png
+.. image:: /images/community/games/game_jam_2020.png
 
 The `Python Discord <https://pythondiscord.com/>`_ 2020 Game Jam finished on
 April 26, 2020. Participants completed a game in one week. Twenty-three teams
@@ -25,7 +25,7 @@ This is a game where the player controls 3 different characters which need to ju
 Check out the
 `source code <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/Score_AAA>`__.
 
-.. figure:: https://raw.githubusercontent.com/python-discord/game-jam-2020/master/Finalists/Score_AAA/ressources/Screenshot_full.png
+.. figure:: /images/community/games/3_keys_on_the_run.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/Score_AAA
     :width: 45%
 
@@ -40,7 +40,7 @@ the game together nicely. The graphics in this game were quite beautiful and the
 it well. Check out the 
 `source code <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/gamer_gang>`__.
 
-.. figure:: images/gamer_gang.png
+.. figure:: /images/community/games/gamer_gang.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/gamer_gang
     :width: 45%
 
@@ -59,7 +59,7 @@ Hatchlings
 
 Honourable Mention: `Hatchlings <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/KTGames>`_
 
-.. figure:: https://raw.githubusercontent.com/python-discord/game-jam-2020/master/Finalists/KTGames/rd_images/OpeningScreen.png
+.. figure:: /images/community/games/hatchlings.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/KTGames
     :width: 45%
 
@@ -68,7 +68,7 @@ Gem Matcher
 
 Honourable Mention: `Gem Matcher <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/artemis>`_
 
-.. figure:: https://raw.githubusercontent.com/python-discord/game-jam-2020/master/Finalists/artemis/assets/tutorial.gif
+.. figure:: /images/community/games/gem_matcher.gif
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/artemis
     :width: 45%
 
@@ -78,7 +78,7 @@ Tri-Chess
 
 Honourable Mention: `Tri-Chess <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/TriChess>`_
 
-.. figure:: https://raw.githubusercontent.com/python-discord/game-jam-2020/master/Finalists/TriChess/assets/hex_board.PNG
+.. figure:: /images/community/games/tri-chess.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/TriChess
     :width: 45%
 
@@ -87,7 +87,7 @@ Insane Irradiated Insectz
 
 Honourable Mention: `Insane Irradiated Insectz <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/beanoculars>`_
 
-.. figure:: https://raw.githubusercontent.com/python-discord/game-jam-2020/master/Finalists/beanoculars/submission/images/screen1.png
+.. figure:: /images/community/games/insane.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/beanoculars
     :width: 45%
 
@@ -96,7 +96,7 @@ Flimsy Billy's Coin Dash 3
 
 Honourable Mention: `Flimsy Billy's Coin Dash 3: Super Tag 3 Electric Tree <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/the-friendly-snakes>`_
 
-.. figure:: images/friendly_snakes.png
+.. figure:: /images/community/games/friendly_snakes.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/the-friendly-snakes
     :width: 45%
 
@@ -105,7 +105,7 @@ ZeYoughEzh
 
 Honourable Mention: `ZeYoughEzh <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/zeyoghezh>`_
 
-.. figure:: images/zeyoghezh.png
+.. figure:: /images/community/games/zeyoghezh.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/zeyoghezh
     :width: 45%
 
@@ -115,6 +115,6 @@ Coin Collector
 
 Honourable Mention: `Coin Collector <https://github.com/python-discord/game-jam-2020/tree/master/Finalists/AtieP>`_
 
-.. figure:: images/atie.png
+.. figure:: /images/community/games/atie.png
     :target: https://github.com/python-discord/game-jam-2020/tree/master/Finalists/AtieP
     :width: 45%

doc/games/index.rst renamed to doc/community/games/index.rst

@@ -16,7 +16,7 @@ You also might want to check out sample Arcade games from:
 Brazier
 ~~~~~~~
 
-.. image:: https://img.itch.zone/aW1nLzE2NDkzMDIyLnBuZw==/315x250%23c/2l4Uej.png
+.. image:: /images/community/games/brazier.png
    :width: 400px
 
 - [Itch page](https://dragonmoffon.itch.io/brazier)
@@ -25,7 +25,7 @@ Brazier
 PhotoShip
 ~~~~~~~~~
 
-.. image:: https://img.itch.zone/aW1hZ2UvMjc2NDUxOC8xNjQ5MjYwOC5wbmc=/794x1000/aPyjik.png
+.. image:: /images/community/games/photoship.png
    :width: 400px
 
 - [Itch page](https://clodon.itch.io/photoship)
@@ -37,7 +37,7 @@ Space Station Builder
 
 Build your own space station!
 
-.. image:: https://img.itch.zone/aW1hZ2UvMjY5NTk3NC8xNjA3MTA2Ni5naWY=/794x1000/ONUlqh.gif
+.. image:: /images/community/games/space_station_builder.gif
    :width: 500px
 
 Download at [Kosmolonia on itch.io](https://aliskda.itch.io/kosmolonia).
@@ -47,15 +47,15 @@ Notepad Doodles
 
 Survive waves of monsters!
 
-.. image:: https://img.itch.zone/aW1hZ2UvMjYxOTIxOS8xNjE5MTMxMi5wbmc=/original/dGbRh5.png
+.. image:: /images/community/games/notepad_doodles.png
    :width: 400px
 
 Download at [Notepad Doodles on itch.io](https://arkturdev.itch.io/notepad-doodles).
 
 BoxHead Survivor
 ~~~~~~~~~~~~~~~~
 
-.. image:: https://img.itch.zone/aW1hZ2UvMjM1MTM4Mi8xMzkyODQ1Ni5qcGc=/original/YI7uLX.jpg
+.. image:: /images/community/games/boxhead_survivor.jpg
    :width: 560px
 
 A top-down 2D shooter game.
@@ -95,7 +95,7 @@ Binary Defense
 Space Invaders
 ~~~~~~~~~~~~~~
 
-.. image:: https://github.com/pvcraven/space_invaders/raw/main/screenshot.png
+.. image:: /images/community/games/space_invaders.png
    :width: 560px
 
 `Space Invaders <https://github.com/pvcraven/space_invaders>`_
@@ -113,8 +113,7 @@ RPG by Akash S Panickar.
 Age of Divisiveness
 ~~~~~~~~~~~~~~~~~~~
 
-
-.. image:: https://raw.githubusercontent.com/chceswieta/age-of-divisiveness/main/resources/promo/city_build.gif
+.. image:: /images/community/games/age_of_divisiveness.gif
    :width: 75%
 
 `Age of Divisiveness <https://github.com/chceswieta/age-of-divisiveness>`_ by
@@ -126,7 +125,7 @@ Very extensive.
 Fishy-Game
 ~~~~~~~~~~
 
-.. image:: https://raw.githubusercontent.com/LiorAvrahami/fishy-game/main/example%20image.png
+.. image:: /images/community/games/fishy-game.png
    :width: 75%
 
 `Fishy Game <https://github.com/LiorAvrahami/fishy-game>`_ by LiorAvrahami
@@ -143,7 +142,7 @@ Adventure
 Transcience Animation
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: https://raw.githubusercontent.com/SunTzunami/Transience_animation_PyArcade/master/Demo/preview.gif
+.. image:: /images/community/games/transcience.gif
    :width: 75%
 
 `Transcience Animation <https://github.com/SunTzunami/Transience_animation_PyArcade>`_
@@ -161,15 +160,15 @@ Stellar Arena Demo
 Battle Bros
 ~~~~~~~~~~~
 
-.. image:: https://raw.githubusercontent.com/njbittner/battle-bros-pyarcade/master/battlebros.gif
+.. image:: /images/community/games/battlebros.gif
    :width: 50%
 
 `Battle Bros <https://github.com/njbittner/battle-bros-pyarcade>`_ Mortal Kombat style game.
 
 Rabbit Herder
 ~~~~~~~~~~~~~
 
-.. image:: https://raw.githubusercontent.com/ryancollingwood/arcade-rabbit-herder/master/resources/static/preview.gif
+.. image:: /images/community/games/rabbit_herder.gif
    :width: 50%
 
 `Rabbit Herder <https://github.com/ryancollingwood/arcade-rabbit-herder>`_,
@@ -189,46 +188,46 @@ The Great Skeleton War
 Python Knife Hit
 ~~~~~~~~~~~~~~~~
 
-.. figure:: images/python_knife_hit.png
+.. figure:: /images/community/games/python_knife_hit.png
 	:width: 50%
 
 https://github.com/akmalhakimi1991/python-knife-hit
 
 Kayzee
 ~~~~~~
 
-.. figure:: images/kayzee.png
+.. figure:: /images/community/games/kayzee.png
 	:width: 50%
 
 	`Kayzee Game <https://github.com/wamiqurrehman093/Kayzee>`_
 
 lixingqiu Games
 ~~~~~~~~~~~~~~~
 
-.. figure:: images/eight_planet.gif
+.. figure:: /images/community/games/eight_planet.gif
 	:width: 50%
 
 	An `Eight planet simulation <https://github.com/lixingqiu/eight_planet>`_
 
-.. figure:: images/midway.png
+.. figure:: /images/community/games/midway.png
 	:width: 50%
 
 	`Midway Island War <https://github.com/lixingqiu/python3_arcade_midway_island_war_simple_simulate>`_
 
-.. figure:: images/angry_bird.gif
+.. figure:: /images/community/games/angry_bird.gif
 	:width: 50%
 
 	`Angry Bird <https://github.com/lixingqiu/python_arcade_simple_angry_bird>`_
 
-.. figure:: images/octopus.gif
+.. figure:: /images/community/games/octopus.gif
 	:width: 50%
 
 	`Octopus <https://github.com/lixingqiu/Python-arcade-Octopus-animation-demo>`_
 
 Space Typer
 ~~~~~~~~~~~
 
-.. image:: images/space_typer.png
+.. image:: /images/community/games/space_typer.png
    :width: 75%
 
 `Space Typer`_ - A typing game
@@ -239,7 +238,8 @@ Space Typer
 FlapPy Bird
 ~~~~~~~~~~~
 
-.. image:: https://camo.githubusercontent.com/b373859d570155b72030f36ae7ece8b9575bda6d45eb0695f5a060d3dfa27dab/68747470733a2f2f692e706f7374696d672e63632f665678394b736b672f53637265656e5f53686f745f323031382d30392d32375f61745f31322e31312e31395f414d2e706e67
+.. image:: /images/community/games/flappy.png
+   :width: 25%
 
 `FlapPy-Bird`_ - A bird-game clone.
 
@@ -251,7 +251,7 @@ FlapPy Bird
 PyOverheadGame
 ~~~~~~~~~~~~~~
 
-.. image:: images/PyOverheadGame.png
+.. image:: /images/community/games/PyOverheadGame.png
    :width: 75%
 
 PyOverheadGame_, a 2D overhead game where you go through several rooms and pick up keys and other objects.
@@ -262,7 +262,7 @@ PyOverheadGame_, a 2D overhead game where you go through several rooms and pick
 Dungeon
 ~~~~~~~
 
-.. image:: images/blake.png
+.. image:: /images/community/games/blake.png
    :width: 75%
 
 Dungeon_, explore a maze picking up arrows and coins.
@@ -272,15 +272,15 @@ Dungeon_, explore a maze picking up arrows and coins.
 Two Worlds
 ~~~~~~~~~~
 
-.. image:: https://camo.githubusercontent.com/a74f38285980087502aec7795e10bec5869e71c840a35729fa37edf6ad17858d/68747470733a2f2f696d6775722e636f6d2f634372674171712e706e67
+.. image:: /images/community/games/two_worlds.png
    :width: 75%
 
 `Two Worlds`_, a castle adventure with a dungeon and caverns underneath it.
 
 .. _Two Worlds: https://github.com/pvcraven/two_worlds
 
 Simpson College Spring 2017 CMSC 150 Course
--------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 These games were created by first-semester programming students.