<story><title>Learn by reading code: Python standard library design decisions explained</title><url>https://death.andgravity.com/stdlib</url></story><parent_chain><item><author>ainzzorl</author><text>&amp;gt; &amp;quot;There are so many projects on GitHub – pick one you like and see how they did it.&amp;quot; But most successful projects are quite large; where do you start from?&lt;p&gt;I&amp;#x27;m working on a slightly similar project motivated by this problem: how do you learn from established open-source projects - most interesting ones are too big, too complex, to hard to get started with.&lt;p&gt;So I&amp;#x27;m compiling a collection of interesting code examples from open-source projects and explaining&amp;#x2F;annotating them. I&amp;#x27;m trying to pick examples that are:&lt;p&gt;- Taken from popular, established open-source projects.&lt;p&gt;- Somewhat self-contained. They can be understood with little knowledge of the surrounding context.&lt;p&gt;- Small-ish. The can be understood in one sitting.&lt;p&gt;- Non-trivial.&lt;p&gt;- Instructive. They solve somewhat general problems, similar to what some other coders on some other projects could be facing.&lt;p&gt;- Good code, at least in my opinion.&lt;p&gt;I&amp;#x27;m planning to share it in a few weeks.</text></item></parent_chain><comment><author>mttpgn</author><text>&amp;gt; &amp;gt; where do you start from?&lt;p&gt;My answer for this has been to scroll all the way through the git history of a repo structurally similar to something I want to do and read each of the first month-or-so of commits.</text></comment>
<story><title>Learn by reading code: Python standard library design decisions explained</title><url>https://death.andgravity.com/stdlib</url></story><parent_chain><item><author>ainzzorl</author><text>&amp;gt; &amp;quot;There are so many projects on GitHub – pick one you like and see how they did it.&amp;quot; But most successful projects are quite large; where do you start from?&lt;p&gt;I&amp;#x27;m working on a slightly similar project motivated by this problem: how do you learn from established open-source projects - most interesting ones are too big, too complex, to hard to get started with.&lt;p&gt;So I&amp;#x27;m compiling a collection of interesting code examples from open-source projects and explaining&amp;#x2F;annotating them. I&amp;#x27;m trying to pick examples that are:&lt;p&gt;- Taken from popular, established open-source projects.&lt;p&gt;- Somewhat self-contained. They can be understood with little knowledge of the surrounding context.&lt;p&gt;- Small-ish. The can be understood in one sitting.&lt;p&gt;- Non-trivial.&lt;p&gt;- Instructive. They solve somewhat general problems, similar to what some other coders on some other projects could be facing.&lt;p&gt;- Good code, at least in my opinion.&lt;p&gt;I&amp;#x27;m planning to share it in a few weeks.</text></item></parent_chain><comment><author>TheFreim</author><text>This is very interesting to me. Do you have a blog or some other way of keeping track of this?</text></comment>