That would be a good idea. I'll update my main description to point to 
Pyglet as right now it is just in the development notes.

On Friday, June 23, 2017 at 7:33:31 PM UTC-5, Benjamin Moran wrote:
>
> Hey Paul,
>
> Good to see you here. I've been thinking that we can add a section in the 
> documentation for "Projects using pyglet". If it's OK with you, Arcade 
> seems like a good choice for that.  Something like: 
>
> Arcade:  <Short description of the project. A few lines. >
> http://www.link-to-project-page.com
>
> Project B: <Short description of the project. A few lines.>
> http://www.some-other-link.com
>
>
>
> On Saturday, June 24, 2017 at 2:13:47 AM UTC+9, Paul Craven wrote:
>>
>> Here's an example of a with a lot of example code:
>>
>> http://arcade.academy/examples/index.html
>>
>> Arcade it built on Pyglet, but designed to be easier for new programmers.
>>
>> On Thursday, June 22, 2017 at 10:10:20 AM UTC-5, Benjamin Moran wrote:
>>
>>> Thanks for your comments, Max. 
>>>
>>> I've asked around on different forums, and the feedback I've seen has 
>>> been similar to yours.
>>>
>>> I'm very grateful to Steve for stepping up to the plate here and getting 
>>> things moving. I've been busy this last week, but im going through the 
>>> programming guide a little each day and making small changes and fixes. 
>>> When I'm done with that, I will start reworking Steve's guide into a new 
>>> section.  I think I'm also going to drop the "upgrading from 1.1" section, 
>>> since that's really out of date at this point. There are maybe some good 
>>> points in there, however, so if it makes sense these can get added to the 
>>> other sections.
>>>
>>> I'll let you guys know when I've pushed those docs, and hopefull we can 
>>> get a few eyes on it. 
>>>
>>>
>>>
>>> On Thursday, June 22, 2017 at 10:43:59 PM UTC+9, Max Greason wrote:
>>>>
>>>> Hello! I'm a new user to Pyglet - I was looking for a 
>>>> graphics-and-other-stuff library to get started on making applications 
>>>> with 
>>>> more than a CLI, and when looking at what options were out there, Pyglet 
>>>> seemed like an attractive option. (I kept seeing opinions of the form 
>>>> "Pyglet would be a better API than Pygame, but I can't recommend it 
>>>> because 
>>>> the community is dead, the documentation is a bit crap, and it's not 
>>>> maintained." Since Pyglet seems to be maintained again, and I was willing 
>>>> to try looking through source if the docs were insufficient, I thought I'd 
>>>> take a crack.)
>>>>
>>>> So from the perspective of a new user, I can absolutely vouch that the 
>>>> "Writing a Pyglet Application" section really, really, needs something 
>>>> like 
>>>> an "Example application" section. Right now, it simply ends with "The 
>>>> examples presented in this chapter should have given you enough 
>>>> information 
>>>> to get started writing simple arcade and point-and-click-based games", 
>>>> which - no. Given what information is actually provided by the examples, 
>>>> not only is that deeply intimidating, it's borderline **insulting**. 
>>>> "Here's "Hello, World." Here's a way to draw a static image. Here's a way 
>>>> to play an .mp3 file. Here's a way to do something when someone presses a 
>>>> key. If you can't figure out how to make Space Invaders from that, kindly 
>>>> fuck off." It *sort of* looks like enough, but the moment you try to 
>>>> actually do something with it, you start running into questions like 
>>>> "Where 
>>>> do I put my game logic? Surely not all inside on_key_press?" and "Once 
>>>> I've 
>>>> drawn an object, how do I make it move?" 
>>>>
>>>> Judging from the comments I saw elsewhere where people were asking 
>>>> about Pyglet vs Pygame, this experience seems to be typical.
>>>>
>>>> (And there's no mention of sprites at all, which as far as I can tell 
>>>> are how you're actually *supposed* to draw images for game stuff judging 
>>>> by 
>>>> the rest of the docs)
>>>>
>>>> An example arcade-type game would be *extremely* valuable. The 2009 
>>>> tutorial that Steve Johnson posted up there for a simple Asteroids game 
>>>> would be basically perfect, if updated to 1.3. 
>>>>
>>>> On Sunday, June 11, 2017 at 9:40:38 PM UTC-5, Benjamin Moran wrote:
>>>>>
>>>>> I started pitching in a little by going through the programming guide 
>>>>> and making some small changes for clarity.
>>>>>
>>>>> After a first pass over, I'll start adapting your game example. Right 
>>>>> now, the "Writing a Pyglet Application" ends with "Where to next?". I'm 
>>>>> thinking that we need a new top level section (perhaps at the bottom), 
>>>>> titled something like "A more in-depth example application", or "Example 
>>>>> Application #1" (if we plan to add more). The "Where to next" can point 
>>>>> to 
>>>>> that. 
>>>>>
>>>>> I'm also thinking that it's long past time to remove "Appendix: 
>>>>> Migrating to pyglet 1.1". There is a lot of useful information in there, 
>>>>> however, so we should also improve the relevant sections with this info 
>>>>> if 
>>>>> it makes sense. 
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>

-- 
You received this message because you are subscribed to the Google Groups 
"pyglet-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to pyglet-users+unsubscr...@googlegroups.com.
To post to this group, send email to pyglet-users@googlegroups.com.
Visit this group at https://groups.google.com/group/pyglet-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to