Skip to content

Commit 35f2092

Browse files
committed
chore: refactor potentially relevant discussions
1 parent bae152f commit 35f2092

File tree

1 file changed

+4
-11
lines changed

1 file changed

+4
-11
lines changed

patterns/2-structured/discover-your-innersource.md

Lines changed: 4 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -26,12 +26,16 @@ People don't bother looking for internally developed solutions - they might not
2626
- might not be maintained
2727
- might have poor reusability
2828
- 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
2930

3031
## Solution
3132

3233
Make it easy to find the reusable code.
3334

3435
* 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
3539
* Implement process change to first check for internal solutions for this problem.
3640
* Tool with a central view (but people are more inclined to google externally than look internally)
3741
* 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.
7680
* Not looking for stuff internally
7781
* Don't bother looking
7882
* 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)?
83-
* https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/60
84-
* 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

Comments
 (0)