Rule 1 - Maybe, we need to say that code of conduct is a relatively new thing, so we it is still not clear how it helps attracting or retaining newcomers (https://www.win.tue.nl/~aserebre/SANER2017.pdf).
Rule 2 - I like it
Rule 3 - I like the idea of adding something more explicit showing that newcomers are welcome in addition to what is there.
Rule 4 - Looks good for me. I agree that we can dismiss the Figure
Rule 5 - I feel we need to introduce LPP up front. Then we start. Other than that, I like it
Rule 6 - ...
Rule 7 - I like the idea of rewording caution... it too strong
Rule 8 -
Rule 9 - I would change the title to make it clear that we are talking about local workspace setup/or building the system locally. In [1] I found that workspace setup is an issue reported by newcomers to different projects and was the most reported barrier, which may lead to frustration and demotivation. A quote that we can use from my IEEE Soft paper [2] “I am still trying to build, because many errors occurred [...] I was expecting to moveforward, because so far I did not have time to look at the source code [...] It is frustrating.”
Rule 10 - It is a great last rule. I liked finishing with that. But, I feel it is a bit shallow. The issue is, I don't know what exactly to do there... Maybe it needs a "how to make it happen," how to keep make people feel proud and recognized... not sure
[1]
@inproceedings{Steinmacher:2014:HLO:2593702.2593704,
author = {Steinmacher, Igor and Wiese, Igor Scaliante and Conte, Tayana and Gerosa, Marco Aurelio and Redmiles, David},
title = {The Hard Life of Open Source Software Project Newcomers},
booktitle = {Proceedings of the 7th International Workshop on Cooperative and Human Aspects of Software Engineering},
series = {CHASE 2014},
year = {2014},
isbn = {978-1-4503-2860-9},
location = {Hyderabad, India},
pages = {72--78},
numpages = {7},
doi = {10.1145/2593702.2593704},
publisher = {ACM},
address = {New York, NY, USA},
}
[download]
[2]
@article{Steinmacher.Treude.Gerosa_2018,
author={I. {Steinmacher} and C. {Treude} and M. {Gerosa}},
journal={IEEE Software},
title={Let me in: Guidelines for the Successful Onboarding of Newcomers to Open Source Projects},
year={2018},
doi={10.1109/MS.2018.110162131},
ISSN={0740-7459}}
Rule 1 - Maybe, we need to say that code of conduct is a relatively new thing, so we it is still not clear how it helps attracting or retaining newcomers (https://www.win.tue.nl/~aserebre/SANER2017.pdf). Rule 2 - I like it Rule 3 - I like the idea of adding something more explicit showing that newcomers are welcome in addition to what is there. Rule 4 - Looks good for me. I agree that we can dismiss the Figure Rule 5 - I feel we need to introduce LPP up front. Then we start. Other than that, I like it Rule 6 - ... Rule 7 - I like the idea of rewording caution... it too strong Rule 8 - Rule 9 - I would change the title to make it clear that we are talking about local workspace setup/or building the system locally. In [1] I found that workspace setup is an issue reported by newcomers to different projects and was the most reported barrier, which may lead to frustration and demotivation. A quote that we can use from my IEEE Soft paper [2] “I am still trying to build, because many errors occurred [...] I was expecting to moveforward, because so far I did not have time to look at the source code [...] It is frustrating.” Rule 10 - It is a great last rule. I liked finishing with that. But, I feel it is a bit shallow. The issue is, I don't know what exactly to do there... Maybe it needs a "how to make it happen," how to keep make people feel proud and recognized... not sure
[1] @inproceedings{Steinmacher:2014:HLO:2593702.2593704, author = {Steinmacher, Igor and Wiese, Igor Scaliante and Conte, Tayana and Gerosa, Marco Aurelio and Redmiles, David}, title = {The Hard Life of Open Source Software Project Newcomers}, booktitle = {Proceedings of the 7th International Workshop on Cooperative and Human Aspects of Software Engineering}, series = {CHASE 2014}, year = {2014}, isbn = {978-1-4503-2860-9}, location = {Hyderabad, India}, pages = {72--78}, numpages = {7}, doi = {10.1145/2593702.2593704}, publisher = {ACM}, address = {New York, NY, USA}, }
[download]
[2] @article{Steinmacher.Treude.Gerosa_2018, author={I. {Steinmacher} and C. {Treude} and M. {Gerosa}}, journal={IEEE Software}, title={Let me in: Guidelines for the Successful Onboarding of Newcomers to Open Source Projects}, year={2018}, doi={10.1109/MS.2018.110162131}, ISSN={0740-7459}}