Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Save more on your purchases! discount-offer-chevron-icon
Savings automatically calculated. No voucher code required.
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Newsletter Hub
Free Learning
Arrow right icon
timer SALE ENDS IN
0 Days
:
00 Hours
:
00 Minutes
:
00 Seconds
Arrow up icon
GO TO TOP
Modern Programming: Object Oriented Programming and Best Practices

You're reading from   Modern Programming: Object Oriented Programming and Best Practices Deconstruct object-oriented programming and use it with other programming paradigms to build applications

Arrow left icon
Product type Paperback
Published in Jun 2019
Publisher Packt
ISBN-13 9781838986186
Length 266 pages
Edition 1st Edition
Arrow right icon
Author (1):
Arrow left icon
Graham Lee Graham Lee
Author Profile Icon Graham Lee
Graham Lee
Arrow right icon
View More author details
Toc

Table of Contents (18) Chapters Close

About the Book 1. Part One – OOP The Easy Way FREE CHAPTER
2. Antithesis 3. Thesis 4. Synthesis 5. Part Two – APPropriate Behavior
6. Tools That Support Software Development 7. Coding Practices 8. Testing 9. Architecture 10. Documentation 11. Requirements Engineering 12. Learning 13. Critical Analysis 14. Business 15. Teamwork 16. Ethics 17. Philosophy

Documentation Is More Useful Than You Might Think

A common reason given for not documenting code is that the source code is accurate documentationhttp://www.codinghorror.com/blog/2012/04/learn-to-read-the-source-luke.html; that, while documentation can be created with errors in it or can become inaccurate as the software changes, the source is guaranteed to be both an exactly accurate and exactly precise description of what the software does.

If you assume that framework and compiler bugs don't exist, then this idea is correct: the source is complete and exact documentation of the software's behavior. The problem is, it's not always the most appropriate documentation to read.

Sure, source code is entirely accurate, but it's also at the lowest possible level of abstraction. If you've just been brought onto a project and need to get to grips with the unfamiliar software, reading each operation in sequence (once you've even worked out the correct sequence...

lock icon The rest of the chapter is locked
Register for a free Packt account to unlock a world of extra content!
A free Packt account unlocks extra newsletters, articles, discounted offers, and much more. Start advancing your knowledge today.
Unlock this book and the full library FREE for 7 days
Get unlimited access to 7000+ expert-authored eBooks and videos courses covering every tech area you can think of
Renews at €18.99/month. Cancel anytime