Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

3.15.17 DSpace: How to Contribute Webinar Slides

408 views

Published on

Hot Topics: The DuraSpace Community Webinar Series,
“Introducing DSpace 7: Next Generation UI”

Curated by Claire Knowles, Library Digital Development Manager, The University of Edinburgh.

“How to contribute to DSpace –be a part of the team!”
March 15, 2017 presented by: Claire Knowles - The University of Edinburgh, Maureen Walsh – The Ohio State University, Bram Luyten – Atmire, Hardy Pottinger – UCLA Library & Kim Shepherd - DSpace Developer and Committer

Published in: Technology
  • Be the first to comment

  • Be the first to like this

3.15.17 DSpace: How to Contribute Webinar Slides

  1. 1. Hot Topics: DuraSpace Community Webinar Series Hot Topics: The DuraSpace Community Webinar Series Series Fifteen: Introducing DSpace 7: Next Generation UI
  2. 2. Hot Topics: DuraSpace Community Webinar Series Hot Topics: The DuraSpace Community Webinar Series Curated by Claire Knowles, Library Digital Development Manager, The University of Edinburgh
  3. 3. Hot Topics: DuraSpace Community Webinar Series Webinar 3: How to contribute to DSpace – be a part of the team! Presented by: Claire Knowles, The University of Edinburgh Maureen Walsh, The Ohio State University Bram Luyten, Atmire Hardy Pottinger, UCLA Library Kim Shepherd, DSpace Developer and Committer
  4. 4. Introductions Bram Luyten, Atmire Maureen Walsh, Ohio State University
  5. 5. Hardy Pottinger, UCLA Library Kim Shepherd Introductions
  6. 6. Overview •Contribution is more than code •There is a medium for every type of contribution •Getting & giving free support •Squashing bugs & development with Jira •Helping with documentation •Contributing effectively
  7. 7. Contribution is more than code •Helping other users •Shaping the future of the platform •Improving the documentation •Advocacy at conferences and events •“Active listening” and empathy
  8. 8. DSpace Community Advisory Team (DCAT)
  9. 9. DCAT Activities • Recommendations to DSpace Steering and Leadership Groups • Recommendations to DSpace Committers • Sharing Knowledge and Best Practices • Special Projects • Monthly Open Conference Call
  10. 10. Recent Call Topics • ORCID: Experiences - Ambitions – Challenges • DSpace Standard Data Model and DSpace-CRIS: Exploring Convergence • Let's Talk About OAI-PMH • RIOXX Application Profile: UK Only or Wider Interest?
  11. 11. Recent Community Forums • DSpace Authentication and Authorization Demystified • DSpace Importing and Bulk Metadata Editing • DSpace Statistics • Using Crosswalks in DSpace http://tinyurl.com/dspace-dcat-meeting-notes
  12. 12. Testathon Projects DSpace 6 Testathon Testing Plans •XMLUI Test Plan: http://tinyurl.com/dspace-xmlui-test-plan •JSPUI Test Plan: http://tinyurl.com/dspace-jspui-test-plan http://tinyurl.com/dspace-testplan-wg
  13. 13. DCAT Co-Chairs Bram Luyten, Atmire bram@atmire.com Maureen Walsh, The Ohio State University walsh.260@osu.edu http://tinyurl.com/dspace-dcat
  14. 14. There’s a place for every type of contribution
  15. 15. Getting and giving free support Mailing lists (aka Google Groups) DSpace-tech Tech support DSpace-community Newbies, repo mgr DSpace-devel Development DSpace-tickets AUTO: Tickets from JIRA (see later) DSpace-changelog AUTO: Changes to the code https://wiki.duraspace.org/display/DSPACE/Mailing+Lists
  16. 16. https://groups.google.com/forum/#!forum/dspace-tech
  17. 17. DSpace tech mailing list The good • High volume (~10 active threads/day) • Huge base of subscribers • All types of issues are welcome • Very newbie friendly The challenges • Your question needs to be picked up fast, in order not to go down the list • The free format discussion can be chaotic at times • English
  18. 18. Getting and giving free support Stackoverflow http://stackoverflow.com/questions/tagged/dspace
  19. 19. http://stackoverflow.com/questions/tagged/dspace
  20. 20. http://stackoverflow.com/questi ons/42319547/dspace-total- views-and-download-for-items
  21. 21. http://stackoverflow.com/tags/dspace/topusers
  22. 22. DSpace on Stackoverflow The good • Expert helpers, from DSpace community and beyond • Question askers get rewarded with points • Helpers get rewarded with points • Unanswered questions stay visible The challenges • An extended description of your problem is expected • Not always THAT newbie friendly – ADVICE: READ up before you start to post • English
  23. 23. Non-English speakers Facebook groups • DSpace https://www.facebook.com/groups/dspace/ • DSpace users group DSpace ambassadors • https://wiki.duraspace.org/display/cmtygp/DSpace+Amb assador+Program Conferences and User Groups • https://wiki.duraspace.org/display/DSPACE/Conferences
  24. 24. Squashing bugs & Development
  25. 25. Squashing bugs & Development DuraSpace JIRA http://tinyurl.com/dspace-issues http://tinyurl.com/dspace-dashboard
  26. 26. http://tinyurl.com/dspace-dashboard
  27. 27. https://jira.duraspace.org/browse/DS-3522
  28. 28. http://tinyurl.com/dspace-performance
  29. 29. http://tinyurl.com/dspace-performance
  30. 30. http://tinyurl.com/dspace-low-hanging-fruit
  31. 31. Squashing bugs & Development Get your DuraSpace account today! 1. Send an email to sysadmin@duraspace.org 2. Explain who you are and make it clear you are not a spammer/malicious person 3. Highlight that you need an account for DSpace 4. While you’re at it, you can also request permissions to edit the documentation … up next!
  32. 32. DSpace documentation
  33. 33. DSpace documentation DuraSpace Confluence Wiki Official docs have their own space DSDOC5X, DSDOC6X, … https://wiki.duraspace.org/display/DSDOC6x/ General DSpace Community guidelines and information https://wiki.duraspace.org/display/DSPACE/ The “Community Groups” Space https://wiki.duraspace.org/display/cmtygp/DSpace+Community+Advisory+Team
  34. 34. https://wiki.duraspace.org/display/DSDOC5x/
  35. 35. Helping with Documentation What you can do • Do direct edits in the documentation to correct errors or to make things clearer • Put requests for corrections in comments Challenges • The community maintains DSpace 4, 5 and 6, so docs for all three of them should be maintained • Be as sure and as specific as possible when you make edits.
  36. 36. Helping with Documentation Get your DuraSpace account today! 1. Send an email to sysadmin@duraspace.org 2. Explain who you are and make it clear you are not a spammer/malicious person 3. Highlight that you need an account for DSpace 4. Mention that you request permissions to edit documentation.
  37. 37. Helping with Documentation Get your DuraSpace account today! Seriously, just do that now, it only takes a minute. It’s the first easy step to start contributing! Send an email to sysadmin@duraspace.org
  38. 38. GitHub is Social •You do not need to be a “coder” to have a GitHub account •Simply “following” developers and projects produces useful network data that can be mined (by someone eventually) •Following developers also lets you keep an eye on what they’re working on, and will lead you to interesting places https://help.github.com/articles/be-social/
  39. 39. Contributing Effectively: Doco I see a mistake or gap in a wiki page… Make the change! Don’t be shy!
  40. 40. Contributing Effectively: Support I want to ask a question, but I’m worried it’s silly, or I’m having trouble wording it ● Do it! this community is friendly and gentle and you are helping other people just by asking or “me too”ing! ● Search archives… old threads might contain answers, give you clues or new keywords to search for ● Provide as much information about environment, conditions and steps needed to replicate issue. Puzzled by Gan Khoon Lay, The Noun Project
  41. 41. Contributing Effectively: Support I want to answer questions, but I’m not sure where to start or where to join in ● Visit the Google Groups pages and look for recent threads with 0 replies, or threads where only the OP has replied -- they’re the ones needing the most attention! ● Search list archives, stackoverflow, facebook groups for posts you know something about ● Be proactive! Is there an interesting problem you already solved or trick you figured out? Share with us! Helping Hand by Gan Khoon Lay, The Noun Project
  42. 42. Contributing Effectively: Issues That bug on JIRA is exactly what I see! I wonder if it’ll be fixed in 6.1? Not up to me, though, right?
  43. 43. Contributing Effectively: Issues That bug on JIRA affects my repository! I wonder if it’ll be fixed in 6.1? Not up to me, though, right? Wrong! It’s up to all of us to advocate for proposed and submitted changes ● talk to DCAT ● email the lists ● join IRC / Slack meetings ● vote and comment on JIRA issue ● if there is a PR, test and comment on it, too
  44. 44. Contributing Effectively: Code I’m working on something, but I’m nervous… the code’s not ready… I might have made mistakes…
  45. 45. Your code is ready! If there are things that can be improved in a PR, other developers, testers, committers will help. This is an open, friendly community. We love getting new code from contributors. Share that code! We also have guidelines and conventions in the Wiki. But don’t sweat it, just share it. http://tinyurl.com/dspace-contribution-guide
  46. 46. Contributing Effectively: Code OK, I’ve fixed a bug and pushed a PR up to the DSpace Github repository. Guess I’m all done! Nope! We want to make sure our useful contributions make it into releases, which means actively recruiting testers and reviewers. Make noise on lists, IRC meetings, JIRA to get attention.
  47. 47. Contributing Effectively: i18n, L10n Hm, I have translations that’d be useful, but if XMLUI and JSPUI are obsolete in DSpace 7, is there any point contributing? Yep! Having structured (key/value) data containing translated phrases is useful for any DSpace UI, there will be ways to port this work over.
  48. 48. Contributing Effectively: Testing That PR on Github fixes my bug but nobody has tested or reviewed it, yet. What’s the easiest way to test it out? vagrant-dspace gives you a temporary virtual DSpace environment. It’s great for testing and sandbox play. http://github.com/dspace/vagrant-dspace
  49. 49. Contributing Effectively: Security What if I notice something that I think is a sensitive issue, eg. a security vulnerability affecting live instances Let us know! You can email security@dspace.org with details so that it can be verified and disclosed safely. You should also add your repository to the DSpace registry to make sure you get important security notices http://duraspace.org/registry
  50. 50. How to contribute Claim a ticket and/or join a meeting http://tinyurl.com/dspace-low-hanging-fruit http://tinyurl.com/dspace-dev-meeting Join us on Slack Ask questions / DSpace 7 discussions http://tinyurl.com/dspace-slack DSpace DCAT http://tinyurl.com/dspace-dcat DSpace 7 Outreach Group http://tinyurl.com/dspace7-ui-outreach
  51. 51. Sponsored by Funding for this webinar series comes from our Members. Join your fellow institutions by becoming a DuraSpace Member in support of Visit http://duraspace.org/about_membership

×