Skip to content

Commit a658999

Browse files
authored
Update modular-code.md
Some clean-up of the markdown
1 parent efaa63e commit a658999

File tree

1 file changed

+18
-15
lines changed

1 file changed

+18
-15
lines changed

modular-code.md

Lines changed: 18 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,30 @@
11
**Title:** ??
22

3-
**Statement of Problem:** Development does not want to spend the extra resources needed to develop modular components. As a result, shared components are not reused.
3+
**Statement of Problem:**
4+
Development does not want to spend the extra resources needed to develop modular components. As a result, shared components are not reused.
45

56
**Context:**
6-
There is no corporate mandate for modularized code.
7-
This is a new product/new code, not a legacy product/code.
8-
There is an available repository for sharing code.
9-
Making code modular takes extra effort and time to develop.
7+
* There is no corporate mandate for modularized code.
8+
* This is a new product/new code, not a legacy product/code.
9+
* There is an available repository for sharing code.
10+
* Making code modular takes extra effort and time to develop.
1011

1112
**Forces:**
12-
There is a learning curve to writing code that can be reused.
13-
Extra documentation is required for reusable code.
14-
If you expose it, there is also the spectre of needing to provide support for it.
15-
Some companies have a common components group that develops reusable code, but others feel that such components should be developed by those business lines that are using the components and a library of common components could be established.
13+
* There is a learning curve to writing code that can be reused.
14+
* Extra documentation is required for reusable code.
15+
* If you expose it, there is also the spectre of needing to provide support for it.
16+
* Some companies have a common components group that develops reusable code, but others feel that such components should be developed by those business lines that are using the components and a library of common components could be established.
1617

1718
**Resolution:** ?
18-
- Provide incentives to teams to invest in modular code
19-
- Offer education. Modular code is well-understood; there is a lot of literature in favor of this.
20-
- Establish a checklist of elements to be checked off to classify a component as reusable
21-
- Select certain "success projects," teams that will develop reusable code and demonstrate the long term success
19+
* Provide incentives to teams to invest in modular code
20+
* Offer education. Modular code is well-understood; there is a lot of literature in favor of this.
21+
* Establish a checklist of elements to be checked off to classify a component as reusable
22+
* Select certain "success projects," teams that will develop reusable code and demonstrate the long term success
2223

23-
**Resulting Context:** Time is spent making the shared code modular so it can be reused.
24+
**Resulting Context:**
25+
Time is spent making the shared code modular so it can be reused.
2426

2527
**Author:**
2628

27-
**Status:** Donut
29+
**Status:**
30+
Donut

0 commit comments

Comments
 (0)