Software Engineering material and discussion for starters

I am having hard time understanding concepts about software engineering in Part 2 . Being from non-CS background, I needed some starting point. So I simply asked question about where to start from on forum and got overwhelming response. This is what I love about fastai community.

I thought, it would be good idea to gather all responses about my software engineering question at one place so everyone will have easy access to it.

@Kaspar suggested :
the Gof book has formed many software engineers (me included) : https://en.wikipedia.org/wiki/Design_Patterns

@devforfu suggested :
The Clean Code is also an interesting thing, I would say. The classic books :smile:

@cjwinslow suggested :
If you’re looking for a book The Pragmatic Programmer is a solid choice that is easy to walk through

@fabris suggested :
Go for The Swift Programming Language, a nice resource. You can read about design patterns but in real life nobody uses them.

Please feel free to add more resources about software engineering, so we all can become good DL practitioners as well as software developers.

8 Likes

I understand that some people like this book - but also note that some people (like me) actively dislike it and recommend staying away from it.

I like the others you mentioned. Although you’re missing Martin Fowler’s books, which are great.

4 Likes

Thank you Jeremy for mentioning Martin Flower.
He has very information website as well

https://www.martinfowler.com/design.html

Also, adding link to his book to this thread

https://www.martinfowler.com/books/refactoring.html

1 Like

How do you think, why GoF is a bad choice? Is it kind of obsolete now, or do they describe too “ideal” scenarios that are far away from real-world development?

I’m not Jeremy but in my opinion it’s because people only remember a single design pattern, Singleton, which is actually an anti-pattern in most cases. Just like people only remember bubble sort from an algorithms class.

1 Like

i’m a great fan of Gof and see those patterns in so much work today. However it was create in the c++ days. There must be a more up to date version out there. Maybe the refactoring book of martin fowler talks about the same pattern. He certainly has written about those patterns for java

The answer is simple, coding in 2019 is quite different than in the 90s. Nowadays you can find patterns implemented in very large frameworks. But, at the end of the day, you learn how to use such frameworks rather than how they were built or designed.

BTW, to be a good software engineering study algorithms and look to open source projects especially from Apache foundation or Google. Moreover, create a group of friends to code together :wink:

good frameworks includes lots of good design pattern so nothing changed there.

1 Like

A lot of the patterns are quite specific to particular types of language, and simply aren’t needed or useful for Python. And even for languages where they are relevant, I found them far too abstract to be helpful for my way of thinking - and they don’t solve problems which I find particularly hard to solve thru simply tests and iterative refactoring.

2 Likes

I would personally recommend staying away from all of those resources (at least within the context of FastAI or Data Science). Those books are primarily aimed at people who:

  1. Are using a full-on Object Oriented Language
  2. Writing code that will be maintained for (at least) years

It sounds like you’re having trouble following the callbacks/hooks/partial functions portions of the lessons. This makes sense because these portions are quite a bit different than most of the code that was introduced in Part 1 of the course.

I’d recommend using the same strategies that likely got you through Part 1 (It’s been easy to forget these techniques because there’s much less ‘homework’ in Part 2):

  1. Step through the notebooks very carefully while making edits to see what happens. Take care to make sure you understand what’s going on in each cell.
  2. At some point you may get confused or lost. Simply ask for clarification on the forums. I find that drafting a question will force me to clarify my thoughts and many times end up answering my own question before I’ve even posted it.
  3. Once you understand how something works within the context of the notebooks, try using it on the full FastAI library. For example, once I understood how callbacks worked within the notebooks, I used callbacks to visualize activations of a ResNet.

This approach can be frustrating at times, but I’m confident that it’s the fastest way for you to get up to speed on the software engineer approaches used in the FastAI library. Reading those books will not get you much closer to understanding the specific techniques used in FastAI.

8 Likes

I would say that the books about Software Engineering help to at least structure your coding thinking a bit. During my career, I’ve seen lots of Python/JS/C# code which was hardly readable because was written in a pretty obscure way, with too many commentaries between the lines of code, using global state too much, using god objects, or totally ignoring language’s OOP capabilities, etc. So it means that these people who wrote the code were not familiar with even these simple principles which seems to be obvious. Like, you probably can’t study Linear Algebra without understanding how to add numbers.

The fastai library is structured pretty well though. It decouples models, learners and training loop from each other. It uses callbacks to decouple the specific functionality from the “core”. It also includes lots of tests and proper documentation where it is required. So it actually follows many of these fancy things like SOLID and DRY. Of course, this knowledge comes with experience. You get this experience after many years of coding, or can simplify your journey a bit reading some books :smile:

Sure enough, each book has its limitations and should be treated with a grain of salt. At the end of the day, critical thinking is always a good thing.

2 Likes

books are like transfer learning :slight_smile:

6 Likes

Do you guys try to remember by heart the syntax while coding ? I mean, I am always struggling to remember even many commands that I use everyday. For example: delete a local git branch or remote branch. Where is axis 0 and 1 in numpy … And I think I lost so much of time researching these things

I think practicing is the key to become a better software engineer (even more important than your intelligence). And remembering syntax make me practicing faster. Recently, I tried to use Anki to note every commands that I need to review but I found it is quite limited.

What do you think about this ? I am thinking about develop an application that help people review very short information or can check easily by our phone. I know that the best way to remember thing is really do it, but we don’t always stay with our computer, right ?

I suggest you to take notes by hands. Try to have a Register for your project

1 Like