Skip to content

Commit

Permalink
github_activiness model completed
Browse files Browse the repository at this point in the history
moved to a dedicated folder and included the impact model relating to
the OSS adoption strategy models
  • Loading branch information
lidix91 committed Jan 18, 2016
1 parent beada4b commit 61d7a54
Show file tree
Hide file tree
Showing 4 changed files with 68 additions and 2 deletions.
27 changes: 27 additions & 0 deletions impact-models/activeness_impact.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
<?xml version="1.0" encoding="ISO-8859-1"?><riscoss>
<model version='1.0' last_modification='18/01/2016'>
<relationships>
<impact source="Project Analysability Risk,Analysability Risk" target="Act-LEARN"/>
<impact source="Project Analysability Risk,Analysability Risk" target="Act-Act-Tech"/>
<impact source="Project Bug Risk,Bug Risk" target="Goal-Evolve-Q"/>
<impact source="Project Obsolescence Risk,Obsolescence Risk,Project Activity Risk,Activity Risk" target="Goal-Evolve-DF"/>
<impact source="Project Activity Risk,Activity Risk" target="Act-ASK"/>
</relationships>
<entities>
<event id="Project Analysability Risk"/>
<event id="Project Bug Risk"/>
<event id="Project Obsolescence Risk"/>
<event id="Project Activity Risk"/>
<event id="Analysability Risk"/>
<event id="Bug Risk"/>
<event id="Obsolescence Risk"/>
<event id="Activity Risk"/>

<goal id="Act-LEARN"/>
<goal id="Act-Act-Tech"/>
<goal id="Goal-Evolve-Q"/>
<goal id="Goal-Evolve-DF"/>
<goal id="Act-ASK"/>
</entities>
</model>
</riscoss>
39 changes: 39 additions & 0 deletions risk-models/Maintenance/Activeness/github Activeness/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
= Github Activeness Risks

= Analysed Risks
* **Project Bug Risk**: Refers to the possibility that critical bugs are present and/or not promptly patched.
* **Project Obsolescence Risk**: Refers to a lack of popularity of the project, due to a reduced number of people following it and reporting bugs and opening issues
* **Project Analysability Risk**:Refers to the (lack of) quality of the software to be easily understood from the adopter"
* **Project Activity Risk: Refers to the activeness of the project developers (contributors), their responsiveness in the issue tracker and the stability of the project (including project age)

**Note**: Remember that the risk description can be found in the file: for each risk (<event>), there is the description (<property name='description'.../>)

= Data-Collectors needed
In order to use this risk model, you need to have configured the riscoss-rdc-github data-collector for all the components are hosted in github. Detailed information about this data-collector in https://github.com/RISCOSS/riscoss-data-collector/wiki/GitHub-API-RDC

= Risk Analysis
The github_activeness risk model can be used in 1 and 2-layer configurations. For the 2-layer configuration you need:
- _Project_: in the sense of a software artefact including other software artefacts (OSS or not)
- _OSS Component_: OSS software components included in Projects

==1-layer configuration
You can use these models following these steps:
1. Upload the model in the file _github_activeness_risks.xml_ in RISCOSS.
2. Create a risk configuration. E. g. you can create a risk configuration called _Component Activeness Risks_.
3. Assign _github_activeness_risks.xml_ to layer _OSS Component_.

==2-layer configuration
You can use these models following these steps:
1. Upload the models in files _github_activeness_risks.xml_ and _github_project_activeness_risks.xml_ in RISCOSS.
2. Create a risk configuration. E. g. you can create a risk configuration called Project Activeness Risks_.
3. Assign _github_activeness_risks.xml_ to layer _OSS Component_ and _github_project_activeness_risks.xml_ to layer _Project_.

== Analysing Activeness risks
You can create several entities of type _OSS Component_ or _Project_, the _Project_ ones containing one or more of the _OSS Component_. Then, you will be able to create a Multi-layer analysis sessions:
- choosing an entity of type _OSS Component_ and the risk configuration _Component Activeness Risks_.
- choosing an entity of type _Project_ and the risk configuration _Project Activeness Risks_. In the results, you were be able to see risk results for all the entities involved in the analysis: the project and all the components that it includes.

== Impact on goals
If you want to include the impact over the related goals for the OSS adopter organization goals you also need to use one goal modelling the risk configuration. If you don't have an specific goal model, you can use:
- one of the OSS strategy goal models, the one fitting most with your adoption strategy, located in **goal-models/OSS Adoption Strategies**
- **OSS adoption strategy_impact**: containing the relations between the risks defined in the Activeness risk models and the goals defined in all the OSS adoption strategy models
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="ISO-8859-1"?><riscoss>
<modeln version='2.0' last_modification='04/01/2016'>
<model version='2.0' last_modification='04/01/2016'>
<relationships>
<satisfy source="fuzzified:ci_link" target="CI-not-available"/>
<satisfy function="fx.join.avg(sources)" weight="0.2" source="fuzzified:has_wiki" target="documentation-unavailable"/>
Expand All @@ -25,7 +25,7 @@
<indicate function="fx.evidence.inverse(fx.join.avg(fx.transform.range(sources,0,100)))" source="github:repository-contributions_sum" target="fuzzified:github:repository-contributions_sum"/>
<indicate source="github:repository-issue-openratio" target="fuzzified:github:repository-issue-openratio"/>
<expose function="fx.join.avg(sources)" source="documentation-unavailable" target="Analysability Risk"/>
<expose function="fx.join.avg(sources)" source="fuzzified:github:repository-contributors,fuzzified:github:repository-percent_contributors_did_80_percent_of_commits,fuzzified:github:repository-issue-comments-avg,young-repository,fuzzified:github:repository-pull-requests,project-is-fragile" target="Project "/>
<expose function="fx.join.avg(sources)" source="fuzzified:github:repository-contributors,fuzzified:github:repository-percent_contributors_did_80_percent_of_commits,fuzzified:github:repository-issue-comments-avg,young-repository,fuzzified:github:repository-pull-requests,project-is-fragile" target="Activity Risk"/>
<expose function="fx.join.avg(sources)" source="not-popular,unmaintained-repository" target="Obsolescence Risk"/>
<expose function="fx.join.avg(sources)" source="CI-not-available,high-open-closed-issues-ratio,young-repository" target="Bug Risk"/>
</relationships>
Expand Down

0 comments on commit 61d7a54

Please sign in to comment.