Difference between revisions of "Software Development"
m (fix link) |
(Add Code Quality and Automation sections) |
||
| Line 10: | Line 10: | ||
I can't talk about "Lines of Code" without mentioning that writing software is NOT measured by the number of lines of code you produce! Lines of Code is one of many metrics<ref>Lines of Code is a metric that is simple enough for a pointy-haired boss to understand, in it's simplest definition. Sadly, advanced software engineering concepts like Cyclomatic Complexity are way over their heads; and worse, not used at most/many organizations who employ buzzwords like "lean" and "agile" to appeal to finance rather than to define the rigors and professionalism of their software process. To dive down into this one step further: for true practitioners, '''[https://davenicolette.wordpress.com/2016/05/19/where-agile-goes-to-die/ agile is about results]'''. For people who've never actually learned it, ''agile is about rules''.</ref>. It can be extremely valuable to '''remove''' code, so that should help make the point. If you still don't get it you're lost. Consider: Less code equals less to audit. Less code equals less attack surface. One useful metric is [[wp:cyclomatic complexity]] | I can't talk about "Lines of Code" without mentioning that writing software is NOT measured by the number of lines of code you produce! Lines of Code is one of many metrics<ref>Lines of Code is a metric that is simple enough for a pointy-haired boss to understand, in it's simplest definition. Sadly, advanced software engineering concepts like Cyclomatic Complexity are way over their heads; and worse, not used at most/many organizations who employ buzzwords like "lean" and "agile" to appeal to finance rather than to define the rigors and professionalism of their software process. To dive down into this one step further: for true practitioners, '''[https://davenicolette.wordpress.com/2016/05/19/where-agile-goes-to-die/ agile is about results]'''. For people who've never actually learned it, ''agile is about rules''.</ref>. It can be extremely valuable to '''remove''' code, so that should help make the point. If you still don't get it you're lost. Consider: Less code equals less to audit. Less code equals less attack surface. One useful metric is [[wp:cyclomatic complexity]] | ||
| + | |||
| + | == Code Quality == | ||
| + | Analysis-tools.dev is a website dedicated to Code Quality and static analysis tools<ref>https://analysis-tools.dev/blog/static-analysis-is-broken-lets-fix-it</ref>. On the site, you can find reference to tools such as [https://analysis-tools.dev/tool/ansible-lint Ansible lint]<ref>https://ansible.readthedocs.io/projects/lint/</ref> with Stack Overflow -style comments whereby people can add 'similar' tools (in other words, peer-reviewed recommendations). In short, it's a great way to quickly get familiar with a broad range of code quality tools. | ||
| + | |||
| + | == Automation == | ||
| + | There are many approaches to [[automation and orchestration tools]]. With the current focus on "Cloud Native" and [[Kubernetes]], don't forget that [[Ansible]] is still crucial in your Container Builds, Cluster Management; and Application Lifecycles<ref>https://www.ansible.com/blog/how-useful-is-ansible-in-a-cloud-native-kubernetes-environment - Jan 14, 2020 by Jeff Geerling</ref>. | ||
== See Also == | == See Also == | ||
Revision as of 17:48, 13 January 2024
A lot can, and has been, written about how to develop software, the project methods and processes. We're going to distill some of that here. But really, a wonderful resource on the Internet can be found at the Wikimedia Foundation's Wikitech website where they describe, document and detail all that they do in support of enterprise software engineering to build free software using free software. E.g.
Tools for Estimating[edit | edit source]
One of the biggest challenges for anyone working on software is wp:Software development effort estimation.
I used to use a tool by David Wheeler called 'SLOCCount' (Software Lines Of Code Count), but it had fallen out of maintenance after 2004 . Eric Raymond wrote about this as he wrote a replacement in Go in 2019. A more recent similar tool is Ben Boyter's SCC
I can't talk about "Lines of Code" without mentioning that writing software is NOT measured by the number of lines of code you produce! Lines of Code is one of many metrics[1]. It can be extremely valuable to remove code, so that should help make the point. If you still don't get it you're lost. Consider: Less code equals less to audit. Less code equals less attack surface. One useful metric is wp:cyclomatic complexity
Code Quality[edit | edit source]
Analysis-tools.dev is a website dedicated to Code Quality and static analysis tools[2]. On the site, you can find reference to tools such as Ansible lint[3] with Stack Overflow -style comments whereby people can add 'similar' tools (in other words, peer-reviewed recommendations). In short, it's a great way to quickly get familiar with a broad range of code quality tools.
Automation[edit | edit source]
There are many approaches to automation and orchestration tools. With the current focus on "Cloud Native" and Kubernetes, don't forget that Ansible is still crucial in your Container Builds, Cluster Management; and Application Lifecycles[4].
See Also[edit | edit source]
the WikiTech page
References[edit source]
- ↑ Lines of Code is a metric that is simple enough for a pointy-haired boss to understand, in it's simplest definition. Sadly, advanced software engineering concepts like Cyclomatic Complexity are way over their heads; and worse, not used at most/many organizations who employ buzzwords like "lean" and "agile" to appeal to finance rather than to define the rigors and professionalism of their software process. To dive down into this one step further: for true practitioners, agile is about results. For people who've never actually learned it, agile is about rules.
- ↑ https://analysis-tools.dev/blog/static-analysis-is-broken-lets-fix-it
- ↑ https://ansible.readthedocs.io/projects/lint/
- ↑ https://www.ansible.com/blog/how-useful-is-ansible-in-a-cloud-native-kubernetes-environment - Jan 14, 2020 by Jeff Geerling
