Skip to content

Commit 53d3404

Browse files
intro: elaborate on the purpose of the book
1 parent 09dadde commit 53d3404

File tree

2 files changed

+7
-4
lines changed

2 files changed

+7
-4
lines changed

README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111

1212
## Book Overview
1313

14-
A practical guide to software development practices and tools.
14+
A practical guide to software development principles, practices and effective use of tools.
1515

1616

1717
## Book status
@@ -108,4 +108,3 @@ make docs-changed
108108
```
109109

110110
> NOTE: navigation changes may not be correctly reflected without reloading the page in the web browser or carrying out a full `make docs` build
111-

docs/index.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,18 @@
44

55
A practical guide to engineering practices and common tools for effective software development.
66

7+
Software engineering is a highly engaging career that can keep a person learning for many lifetimes.
8+
9+
The industry is far from perfect, as it is very people intensive after all. Therefore characteristics and emotions should be navigated with care and understanding.
10+
711
!!! QUOTE "Quote: John Stevenson, Practicalli"
812
**Effective Communication** is the fundamental challenge for all software engineering projects
913

1014
!!! QUOTE "Quote: John Stevenson, Practicalli"
1115
When a problem is well-defined in a language that everyone understands, it becomes far simpler to solve
1216

1317
!!! QUOTE "Quote: John Stevenson, Practicalli"
14-
**Overt** enthusiasm is to the detriment of pragmatism
18+
**Overt** enthusiasm is to the detriment of pragmatism.
1519

1620

1721
??? HINT "Engineering Playbook Initiative"
@@ -23,7 +27,7 @@ A practical guide to engineering practices and common tools for effective softwa
2327

2428

2529
??? WARNING "New Book - content under development"
26-
Practicalli Software Engineering was started in November 2023 in an attempt to codify the last few decades of development experience, so this will be an on-going work
30+
Practicalli Software Engineering is an attempt to codify the last few decades of software development experience, so this will be an on-going work.
2731

2832

2933
## Discussions and feedback

0 commit comments

Comments
 (0)