<?xml version="1.0"?>
<rss version="2.0">
	<channel>
		<title>TODO list for Allegro on the wiki</title>
		<link>http://www.allegro.cc/forums/view/618662</link>
		<description>Allegro.cc Forum Thread</description>
		<webMaster>matthew@allegro.cc (Matthew Leverton)</webMaster>
		<lastBuildDate>Fri, 20 May 2022 18:19:34 +0000</lastBuildDate>
	</channel>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>I would like to know if there is any official TODO list for Allegro 5 lying around here, and if not, or if so, I would like to make a wiki page for it.</p><p>SiegeLord told me of the issue tracker for allegro on github, which can be found here.</p><p><a href="https://github.com/liballeg/allegro5/issues">https://github.com/liballeg/allegro5/issues</a></p><p>I&#39;ll start a wiki page for it, and people can edit or not at their leisure if they have definite milestones for allegro to complete or maybe a timeline of releases.</p><p><a href="https://github.com/liballeg/allegro_wiki/wiki/TODO-list-for-Allegro-5">https://github.com/liballeg/allegro_wiki/wiki/TODO-list-for-Allegro-5</a>
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Edgar Reynaldo)</author>
		<pubDate>Mon, 16 May 2022 00:19:08 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>I don&#39;t know of any TODO list specifically. </p><p>I thought of something that we could add to the TODO list. I thought we could use more demo&#39;s and examples and I was wondering how others felt about that.</p><p>Things like Phaser have a huge list of examples (<a href="http://phaser.io/examples">http://phaser.io/examples</a>) demonstrating all aspects of game development. Allegro could do more in this regard.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (amarillion)</author>
		<pubDate>Wed, 18 May 2022 21:43:33 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>A5 has quite a few examples, but I agree, maybe another demo would be nice. There&#39;s also Allegro Vivace, which is a pretty comprehensive tutorial.</p><p>Feel free to add your suggestions to feature requests and suggestions on the TODO page, and if they&#39;re &#39;approved&#39;, they can be added to the TODO.</p><p>I just thought this might be a place to plan for long term goals of Allegro, or short term goals either.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Edgar Reynaldo)</author>
		<pubDate>Thu, 19 May 2022 20:12:29 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>We have documentation on the library. However, I feel it is lacking in substance. We could use a more detailed set of documentation on the library and the examples. Maybe even add example bits of code on some of it.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (DanielH)</author>
		<pubDate>Thu, 19 May 2022 20:55:02 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>That&#39;s a little broad. Do you have any specific entries you would like updated?
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Edgar Reynaldo)</author>
		<pubDate>Thu, 19 May 2022 20:58:18 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>In my experience, the full TODO list is always the <a href="https://github.com/liballeg/allegro5/issues">issues list on GitHub</a>.</p><p>I&#39;d suggest creating an issue with a list of proposed mini-projects (like more demos) that you&#39;d like to do, and bring people&#39;s attention to it.  A wiki page is not really a place to do that. It&#39;s more for static documentation and tutorials, and doesn&#39;t have any notification features for changes or live discussion/contribution.</p><p>GitHub issues is pretty fantastic, to be honest. I&#39;d recommend getting used to all the features, tagging, checkbox lists, etc.</p><p>If we wanted to do something specific, like create a more comprehensive set of demos, I suggest tracking that as a <a href="https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests">milestone</a>.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Mark Oates)</author>
		<pubDate>Thu, 19 May 2022 21:25:09 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>It&#39;s very easy for issues on Github to get completely lost. Right now there are 300 open issues. Are you really going to read the entire issue list?</p><p>The TODO list on the wiki is for an overview of development. Perhaps milestones have their own place on Github, but a separate list of larger issues should be good for allegro.</p><p>Creating an issue for every example / demo that needs to be worked on is a waste of time and is a good way to get ignored.</p><p>Discussion belongs on the mailing list, not the wiki. Of course the wiki can be discussed on the mailing list, so there&#39;s really no need to include discussion on the wiki. The old wiki had discussions and they often went nowhere.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Edgar Reynaldo)</author>
		<pubDate>Thu, 19 May 2022 21:30:54 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><div class="quote_container"><div class="title"><a href="http://www.allegro.cc/forums/thread/618662/1052343#target">Edgar Reynaldo</a> said:</div><div class="quote"><p> Creating an issue for every example / demo that needs to be worked on is a waste of time and is a good way to get ignored.</p></div></div><p>Creating an issue is a great way to do it.  Communication and discussion is automatically opt-in and focused on a specific topic/goal.  The company I worked at had about 1000 employees and it worked fantastically smooth.</p><p>If things are getting lost in the list, then there simply isn&#39;t enough interest in the project/issues, it&#39;s not important enough, or there isn&#39;t enough manpower or management to draw/assign people to the tasks.</p><p>The real advantage of GitHub issues is that everything works the same way. There&#39;s no cross-talk between mailing lists, wiki updates, issues, etc.  Everything is localized and discussion is fluid.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Mark Oates)</author>
		<pubDate>Thu, 19 May 2022 21:51:23 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>Issues are not appropriate for larger tasks. They&#39;re designed to be simple to fix and easy to cross off.</p><p>A TODO list is for longer term goals. Issues don&#39;t belong on it, nor do TODO belong in issues. I have to disagree with you on this.</p><p>There are simply not enough developers to handle this many issues. They are backlogged, out of date, open beyond their lifetime, and are too scattered.</p><p>A TODO list brings larger groups of issues together, as DanielH suggested, working on examples and library documentation is something for a TODO list, not a 100 issues. A TODO list is simply beyond the scope of an issue tracker.</p><p>As you stated earlier, perhaps some of these could be made into milestones. I&#39;m not familiar with how that works on Github, perhaps you could elaborate.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Edgar Reynaldo)</author>
		<pubDate>Thu, 19 May 2022 21:58:52 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>There was a wish list of things people would like to see implemented like clipboard access.</p><p>[EDIT]<br />Didn&#39;t realize it was 8 years ago. I looked up the <a href="https://www.allegro.cc/forums/thread/614921">post</a> I posted about it. There was a wish list for drag/drop. So I implemented a custom event for dragging/dropping files into the display.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (DanielH)</author>
		<pubDate>Thu, 19 May 2022 22:47:26 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>Here&#39;s an example of a GitHub Milestone for AllegroFlare version 0.9:<br /><a href="https://github.com/allegroflare/allegro_flare/milestone/1">https://github.com/allegroflare/allegro_flare/milestone/1</a></p><p>Here&#39;s an example of a single GitHub issue that represents a larger project:<br /><a href="https://github.com/allegroflare/allegro_flare/issues/106">https://github.com/allegroflare/allegro_flare/issues/106</a></p><div class="quote_container"><div class="title"><a href="http://www.allegro.cc/forums/thread/618662/1052345#target">Edgar Reynaldo</a> said:</div><div class="quote"><p> There are simply not enough developers to handle this many issues. They are backlogged, out of date, open beyond their lifetime, and are too scattered.</p></div></div><p>What you just described is an issue.  The thing to do is create a new issue that outlines this problem, and then draw people&#39;s attention to it.  This allows for there to be a centralized location where that particular problem can be discussed and owned. You might even propose a solution, something like <a href="https://github.com/apps/stale">StaleBot</a>, or doing a quick blitz and spending 30 minutes a day to close discussions that are too open-ended or are no longer relevant.</p><p>That&#39;s basically what that 2nd link I have above is (<a href="https://github.com/allegroflare/allegro_flare/issues/106">this issue</a>).  There were too many issues in the AllegroFlare repo, a lot of them were out of date or could be closed with some quick work, so I created an issue and tracked the progress.  Each issue had its own thread/timeline and &quot;discussion&quot;.</p><p>But I think that&#39;s a little off target.  If you&#39;re proposing a new set of things that should be done for Allegro, honestly, I&#39;d still create an issue.  Throw all the ideas that come up into there.  You might try to make other existing lists obsolete (like the &quot;wish list&quot; DanielH mentioned) and consolidate them all into one place.</p><p>For example, here&#39;s an AllegroFlare issue where I list out some proposed new classes:<br /><a href="https://github.com/allegroflare/allegro_flare/issues/90">https://github.com/allegroflare/allegro_flare/issues/90</a>
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Mark Oates)</author>
		<pubDate>Thu, 19 May 2022 22:52:39 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>Allegro uses milestones for some mild organization of issues: <a href="https://github.com/liballeg/allegro5/milestones">https://github.com/liballeg/allegro5/milestones</a>. I&#39;ve also occasionally labeled issues: <a href="https://github.com/liballeg/allegro5/labels">https://github.com/liballeg/allegro5/labels</a>. That said, the additional organizational bureaucracy seems unnecessary unless there&#39;s commitment from someone to actually work towards those goals.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (SiegeLord)</author>
		<pubDate>Fri, 20 May 2022 12:08:44 +0000</pubDate>
	</item>
	<item>
		<description><![CDATA[<div class="mockup v2"><p>I added everything mentioned to the TODO. Some of them, like native clipboard support could have its own issue, and that&#39;s fine, we can link from the TODO to the issue.</p><p>I think the TODO serves a better purpose as a high level overview of what we would like to see implemented in Allegro. It&#39;s not quite the same as a milestone, but milestones could easily be included in the TODO.</p><p>That said I don&#39;t want to repeat everything on the TODO, but rather gather an overview of what needs to be done.</p><p><b>EDIT</b><br />@DanielH<br />Re: Drag and drop - I think it&#39;s a great idea, I use it in my own gui for widgets, but I don&#39;t have native file drag and drop. All that is is passing the name to the app. I think you were on the right track.
</p></div>]]>
		</description>
		<author>no-reply@allegro.cc (Edgar Reynaldo)</author>
		<pubDate>Fri, 20 May 2022 18:19:34 +0000</pubDate>
	</item>
</rss>
