starlee
/
prj_doc
0
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

update figures

This commit is contained in:
whystar 2020-08-21 21:40:26 +08:00
parent 44c9c517e1
commit 238b0dbf0b
5 changed files with 16 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
6_conlusion.tex
View File

@ -5,27 +5,28 @@
In this paper,
we quantitatively investigated the popularity (RQ1) and maintenance (RQ2) of community profile documentation.
we quantitatively investigated the prevalence (RQ1) and maintenance (RQ2) of community profile documentation.
We studied on a sample of 2,000 OSS projects randomly collected from GitHub.
Our analysis indicates that \RDM, and \LIC are far more popular than \CON, \COD and \TMP in OSS projects.
Our analysis indicates that
the \RDM and \LIC documentation is far more pervasive
and included earlier
than the \CON, \COD and \TMP documentation in OSS projects.
We found that repositories of TypeScript and repositories of larger community size are more inclined to include community profile documentation.
We also observed that
\CON, \COD, and \TMP files are more likely to be found in organizations' repositories than personal repositories,
and younger projects are more likely to include \RDM and \COD files than \CON files.
As for maintenance practice,
we identified that
We also observed that the
\CON, \COD, and \TMP documentation is more likely to be found in organizations' repositories than personal repositories.
Younger projects are more likely to include a \RDM file and a \COD file than a \CON file.
We identified that
community profile documentation is mainly placed in the \textit{root} directory rather than the \textit{.github} or \textit{doc} directory.
\RDM and \LIC files were created earlier than \CON, \COD, and \TMP files in OSS projects.
Moreover,
community profile documentation is maintained by a small group of developers with a low frequency of update mainly driven by
perfective and adaptive changes.
Our work enable a better understanding of community profile documentation,
Our work enables a better understanding of community profile documentation,
which can bring benefits for OSS practitioners.
The findings on documentation popularity can
The findings on documentation prevalence can
provide insights into the criteria that can be considered
by OSS developers
when selecting a project with adequate profile documentation to participate in.
The findings on documentation maintenance can
provide reference for OSS maintainer about how to assess and manage the profile documentation in their repositories.
provide reference for OSS maintainers about how to assess and manage the profile documentation in their repositories.

2
experiment_code/1-popularity/overvie.py
View File

@ -291,7 +291,7 @@ def by_forks():
)
plt.legend(ncol=2)
plt.ylim(None,12)
plt.xticks(range(1,6),["README", "LICENSE", "CONTRIBUTING", "CONDUCT", "TEMPLATE"])
plt.xticks(range(0,5),["README", "LICENSE", "CONTRIBUTING", "CONDUCT", "TEMPLATE"])
plt.ylabel("Repository forks (log)")
plt.show()
fig = sns_plot.get_figure()

1
experiment_code/2-maintenance/interval.py
View File

@ -126,6 +126,7 @@ if __name__ == "__main__":
xtcks = ["Readme","License","Contributing","Code-of-conduct","Template"]
plt.xticks(range(1,len(xtcks)+1),xtcks)
# plt.xlim(0,None)
plt.xticks(range(1,6),["README", "LICENSE", "CONTRIBUTING", "CONDUCT", "TEMPLATE"])
plt.ylabel("Maintenance interval (log)")
plt.xlabel("Documentation type")
plt.savefig("../../resources/interval.pdf",dpi=200)

1
experiment_code/2-maintenance/maintainer.py
View File

@ -116,6 +116,7 @@ if __name__ == "__main__":
xtcks = ["Readme","License","Contributing","Code-of-conduct","Template"]
plt.xticks(range(1,len(xtcks)+1),xtcks)
# plt.xlim(0,None)
plt.xticks(range(1,6),["README", "LICENSE", "CONTRIBUTING", "CONDUCT", "TEMPLATE"])
plt.ylabel("The number of maintainers")
plt.xlabel("Documentation type")
plt.savefig("../../resources/maintainers.pdf",dpi=200)

2
scis_paper.tex
View File

@ -105,7 +105,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%% Acknowledgements. <20><>л
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\Acknowledgements{This work was supported by National Natural Science Foundation of China (Grant Nos. 00000000 and 11111111).This work was supported by National Grand R\&D Plan (Grant No. 2018AAA0102304) and National Natural Science Foundation of China (Grant No. 61702534).}
\Acknowledgements{This work was supported by National Grand R\&D Plan (Grant No. 2018AAA0102304) and National Natural Science Foundation of China (Grant No. 61702534).}