3.15.17 dspace: how to contribute webinar slides
TRANSCRIPT
Hot Topics: DuraSpace Community Webinar Series
Hot Topics: The DuraSpace Community Webinar Series
Series Fifteen:
Introducing DSpace 7: Next Generation UI
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
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, AtmireHardy Pottinger, UCLA LibraryKim Shepherd, DSpace Developer and Committer
Introductions
Bram Luyten, Atmire
Maureen Walsh, Ohio State University
Hardy Pottinger,UCLA Library
Kim Shepherd
Introductions
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
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
DSpace Community Advisory Team (DCAT)
DCAT Activities• Recommendations to DSpace Steering and
Leadership Groups• Recommendations to DSpace Committers• Sharing Knowledge and Best Practices• Special Projects• Monthly Open Conference Call
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?
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
Testathon ProjectsDSpace 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
DCATCo-Chairs
Bram Luyten, [email protected] Maureen Walsh, The Ohio State [email protected]
http://tinyurl.com/dspace-dcat
There’s a place for every type of contribution
Getting and giving free support
Mailing lists (aka Google Groups)DSpace-tech Tech supportDSpace-community Newbies, repo mgrDSpace-devel DevelopmentDSpace-tickets AUTO: Tickets from JIRA (see later)DSpace-changelog AUTO: Changes to the code
https://wiki.duraspace.org/display/DSPACE/Mailing+Lists
https://groups.google.com/forum/#!forum/dspace-tech
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
Getting and giving free support
Stackoverflowhttp://stackoverflow.com/questions/tagged/dspace
http://stackoverflow.com/questions/tagged/dspace
http://stackoverflow.com/questions/42319547/dspace-total-views-and-download-for-items
http://stackoverflow.com/tags/dspace/topusers
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
Non-English speakers
Facebook groups• DSpace https://www.facebook.com/groups/dspace/ • DSpace users group
DSpace ambassadors• https://wiki.duraspace.org/display/cmtygp/DSpace+Amba
ssador+Program
Conferences and User Groups• https://wiki.duraspace.org/display/DSPACE/Conferences
Squashing bugs & Development
Squashing bugs & Development
DuraSpace JIRAhttp://tinyurl.com/dspace-issues http://tinyurl.com/dspace-dashboard
http://tinyurl.com/dspace-dashboard
https://jira.duraspace.org/browse/DS-3522
http://tinyurl.com/dspace-performance
http://tinyurl.com/dspace-performance
http://tinyurl.com/dspace-low-hanging-fruit
Squashing bugs & Development
Get your DuraSpace account today!
1. Send an email to [email protected]
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!
DSpace documentation
DSpace documentation
DuraSpace Confluence WikiOfficial docs have their own space DSDOC5X, DSDOC6X, …https://wiki.duraspace.org/display/DSDOC6x/ General DSpace Community guidelines and informationhttps://wiki.duraspace.org/display/DSPACE/
The “Community Groups” Spacehttps://wiki.duraspace.org/display/cmtygp/DSpace+Community+Advisory+Team
https://wiki.duraspace.org/display/DSDOC5x/
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.
Helping with Documentation
Get your DuraSpace account today!
1. Send an email to [email protected]
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.
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 [email protected]
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/
Contributing Effectively: Doco
I see a mistake or gap in a wiki page…
Make the change! Don’t be shy!
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
Contributing Effectively: SupportI 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
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?
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
Contributing Effectively: Code
I’m working on something, but I’m nervous… the code’s not ready… I might have made mistakes…
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
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.
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.
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
Contributing Effectively: Security
What if I notice something that I think is a sensitive issue, eg. a security vulnerability affecting live instancesLet us know! You can email [email protected] 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
How to contribute
Claim a ticket and/or join a meetinghttp://tinyurl.com/dspace-low-hanging-fruithttp://tinyurl.com/dspace-dev-meeting
Join us on Slack Ask questions / DSpace 7 discussionshttp://tinyurl.com/dspace-slack
DSpace DCAThttp://tinyurl.com/dspace-dcatDSpace 7 Outreach Grouphttp://tinyurl.com/dspace7-ui-outreach
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