Skip to content

Commit 3964d28

Browse files
committed
fix: MD032 space around lists
1 parent 9cc6dc6 commit 3964d28

14 files changed

+21
-1
lines changed

.markdownlint.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,6 @@
99
"MD026": false,
1010
"MD029": false,
1111
"MD030": false,
12-
"MD032": false,
1312
"MD033": false,
1413
"MD034": false,
1514
"MD036": false,

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ You are already using InnerSource in your company and want to share your ideas a
1111
## Mission Statement
1212

1313
Our mission in this working group
14+
1415
- Collect and document agreed upon best practices of how to do InnerSource - in the form of patterns
1516
- Continuously publish the most mature patterns as an ebook
1617

meta/pattern-system.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,7 @@ our InnerSource pattern system.
7979
Takashi Iba has published an article in the ACM Digital Library from PLoP 2016:
8080
[A pattern language for creating pattern languages: 364 patterns for pattern
8181
mining, writing, and symbolizing](https://dl.acm.org/citation.cfm?id=3158175&CFID=831673585&CFTOKEN=74341142&qualifier=LU1011674)
82+
8283
- for those without ACM DL access, there is [an earlier draft of the paper from
8384
PLoP 2016](http://www.hillside.net/plop/2016/papers/three/26.3.pdf).
8485

@@ -242,6 +243,7 @@ potential characterization based on the companies structure?
242243
### Russ Rutledge
243244

244245
I like a lot of the other planes suggestions. Wanted to add one more - the point in the lifecycle of the InnerSource project. Does this pattern apply to:
246+
245247
* Pre-launch (prepration to launch) an InnerSource project?
246248
* Launch (initial kick-off)?
247249
* Initial growth?

meta/pattern-template.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ Explains why this is the right solution; using totally different words WHY this
4343
Where has this been seen before? Helps to reinforce that this is a REAL pattern and that you match the context.
4444

4545
May mention:
46+
4647
* A particular business
4748
* Anonymized instances ex: "3 companies have proven that this is a good solution" or "A large financial services org...".
4849

patterns/1-initial/code-consumers.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ TBD
99
# Problem
1010

1111
There's several reasons why we might want to know who's using (consuming) our code. We can't do the following:
12+
1213
* notify downstream users/projects of found (fixed?) vulnerabilities
1314
* audit flow of IP
1415
* kill off code - knowing where (or if) it is used
@@ -29,6 +30,7 @@ The act of opening code allows people to use it without letting you know.
2930
# Solutions
3031

3132
The following are potential solutions that have been proposed to this problem:
33+
3234
* Scan all output artifacts for known signatures (manifests/npm/includes etc)
3335
* Voluntary disclosure/signup upon installation/using
3436
* Search for identifiers/markers in source control

patterns/1-initial/developer-incentive-alignment-for-innersource-contribution.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,16 +25,19 @@ TBD
2525
## Forces
2626

2727
1. Existing attitudes and developer culture
28+
2829
* Team-centric behaviour is not evident. Developers of all levels tend to focus mostly on their own contributions. When stories are assigned, work is often done ‘locally’ and not pushed up or checked in until the end of the sprint.
2930
* Asking developers to push code early and often is met with extreme resistance, accusations of micro-management, or claims that such a practice would slow velocity.
3031
* Existing practice commonly leads to duplicated work, missed requirements, or frequent gaps in the software or process.
3132

3233
2. Need to retain developer talent
34+
3335
* Managers focus heavily on tasks or velocity for developers rather than providing mentorship. Developers view helping or mentoring others as the job of Management, or something “I don’t get paid to do.” Career progression, or other ‘upward mobility paths’ (to receive a raise, for example) are not clearly identified in the organization.
3436
* Existing job descriptions, promotion tracks or compensation bands are opaque or hard to get from the organization’s HR department, resulting in a mixed understanding of job responsibilities. This puts additional pressure on performance review or improvement plans because HR, developers and managers don’t have shared a shared understanding of roles or expectations.
3537
* 'Home growing' developer talent - encouraging career growth within the company - is far cheaper for organizations in the long run than hiring from outside. Studies show employee retention increases as new opportunities, challenges, and paths for learning are introduced.
3638

3739
3. Maintaining the product development lifecycle
40+
3841
* Keeping the status quo is encouraged or reinforced with existing product/project management processes and expectations. Developers and managers are reticent to make changes for fear of putting deadlines or product/business unit goals at risk (note that these often have financial implications for the company and individual). Working on one’s own individual contributions is seen as doing one’s part to protect this lifecycle; efforts outside one’s own individual contributions is seen as disruptive.
3942
* Product/Business unit pressures
4043
* HR - existing resource allocation plans & patterns

patterns/1-initial/improve-findability.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ Historically, the company does not have a culture of sharing code across silos.
3131
## Solution
3232

3333
To help improve findability for inner source projects:
34+
3435
- Provide guidelines for applying clear, meaningful naming conventions to projects, and reinforce the importance of avoiding cryptic code names.
3536
- Include keywords in project descriptions.
3637
- Apply tagging to repositories (validated).

patterns/1-initial/overcome-acquisition-based-silos-developer.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,13 @@ Make the acquired teams feel secure in the new environment by
3838
1. Establish a neutral (well-respected) governance committee _across both companies_ that selects from the different options across these silos to converge and integrate. (_validated_).
3939

4040
2. Come up with rational rules for managing code redundancy as a result of acquisition (_validated_)
41+
4142
- Joint effort between two teams to bring new software into existing platforms. (_validated_)
4243
- If allowable/controllable, initial software selection not tied to job security. (_not validated_)
4344
- Same ground rules as above for determining tooling platforms. (_validated_)
4445

4546
3. Giving developers and middle management good on-boarding training and mentoring with InnerSourcing as part of it. (_not validated_)
47+
4648
- Clear guidance on how to bring their software onto existing platform. (_not validated_)
4749
- Definition of roles including Contributor and Trusted Committer. (_not validated_)
4850

@@ -51,6 +53,7 @@ Make the acquired teams feel secure in the new environment by
5153
5. Give them time to get comfortable with the new environment - a generous, realistic grace period for ramping on new company procedures/processes. Not uncommon for this period to be up to a year but there must be a mutually agreed-to deadline. Being "fully integrated" requires a certain level of representation among Trusted Committers from both companies. (_validated_)
5254

5355
6. Minimum commitment for face to face engagement between the two teams.
56+
5457
- can be representative team from acquiring company meet with team.
5558
- potential Trusted committers from acquired company can meet with parent company.
5659

patterns/1-initial/overcome-acquisition-based-silos-manager.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,13 @@ Make the acquired teams feel secure in the new environment by
4141
1. Establish a neutral (well-respected) governance committee _across both companies_ that selects from the different options across these silos to converge and integrate. (_validated_).
4242

4343
2. Come up with rational rules for managing code redundancy as a result of acquisition (_validated_)
44+
4445
- Joint effort between two teams to bring new software into existing platforms. (_validated_)
4546
- If allowable/controllable, initial software selection not tied to job security. (_not validated_)
4647
- Same ground rules as above for determining tooling platforms. (_validated_)
4748

4849
3. Giving developers and middle management good on-boarding training and mentoring with InnerSourcing as part of it. (_not validated_)
50+
4951
- Clear guidance on how to bring their software onto existing platform. (_not validated_)
5052
- Definition of roles including Contributor and Trusted Committer. (_not validated_)
5153

@@ -54,6 +56,7 @@ Make the acquired teams feel secure in the new environment by
5456
5. Give them time to get comfortable with the new environment - a generous, realistic grace period for ramping on new company procedures/processes. Not uncommon for this period to be up to a year but there must be a mutually agreed-to deadline. Being "fully integrated" requires a certain level of representation among Trusted Committers from both companies. (_validated_)
5557

5658
6. Minimum commitment for face to face engagement between the two teams.
59+
5760
- can be representative team from acquiring company meet with team.
5861
- potential Trusted committers from acquired company can meet with parent company.
5962

patterns/1-initial/overcoming-project-management-time-pressures.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ Customer deadlines and delivery commitments for feature content do not change.
1919
- Aggressive roadmaps for delivery
2020
- Project management concern that engagement will lead to missed deadlines
2121
- Project management concern that Code contribution and/or mentoring may lead to dilution of subject matter expert time spent on their own projects (other teams may require their time).
22+
2223
+ Elimination of rewriting common code saves time (write once, use many times)
2324
+ Crowd-based testing and debugging saves time (and improves quality)
2425
+ The collaboration and synergy of inner sourcing can generate new, innovative features .

0 commit comments

Comments
 (0)