You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: patterns/2-structured/discover-your-innersource.md
+4-11Lines changed: 4 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,12 +26,16 @@ People don't bother looking for internally developed solutions - they might not
26
26
- might not be maintained
27
27
- might have poor reusability
28
28
- if someone put out a SW internally, the expectation is that they wouldn't have time to support it (vs. open source options)
29
+
* Difficulty in adding content to the search index makes it hard for people to find anything
29
30
30
31
## Solution
31
32
32
33
Make it easy to find the reusable code.
33
34
34
35
* Pull in Repo names, descriptions and README.md files into the search engine assuming that a search engine exists. Note: a one-stop-shop kind of search engine for all relevant communication and documentation is difficult to attain. Even when using Github's enterprise offering, people often deploy additional systems like wikis to host content orthogonal to what is in the code repositories, slack channels (or IRC), mailing lists (or even nntp servers), some place to store stuff written down in office formats, search over personal e-mail etc. Several of these systems come with search built-in, but integrating this content in one search box or even just deploying a federated search engine across all sources often doesn't come off-the-shelf.
36
+
* Consider using existing tools:
37
+
* GitHub Enterprise and npmjs have built-in searches on meta-data
38
+
* PayPal's Agora project (planned to be open sourced) addresses similar challenges with data source integration
35
39
* Implement process change to first check for internal solutions for this problem.
36
40
* Tool with a central view (but people are more inclined to google externally than look internally)
37
41
* Concierge service (guide) to help product people find stuff. Might not scale but could be helpful in the beginning.
@@ -76,14 +80,3 @@ Make it easy to find the reusable code.
76
80
* Not looking for stuff internally
77
81
* Don't bother looking
78
82
* Find it Inside
79
-
80
-
## Discussion on
81
-
82
-
* Comments may appear in the timeline but not with the file once it is edited (github)?
* If only X knew what X knew; the internal search engine is bad. No one can find anything because it is difficult to add things to the search index.
85
-
* We have similar challenges getting data sources pulled into the search engine. PayPal is building a project called Agora to do this and they are planning to open source it.
86
-
* Github Enterprise and npmjs have built-in searches on meta-data. Enterprise that opts into these tooling will get some of that functi
87
-
* Software component(s) are available internally but users can't easily find these.
88
-
* This problem is more likely to occur where there are silos in the company (e.g., larger companies; smaller companies may have fewer opportunities for reuse of internally developed software).
89
-
* The company traditionally has been bad at sharing across silos (people don't have the culture of sharing).
0 commit comments