3.15.17 DSpace: How to Contribute Webinar Slides

Hot Topics: DuraSpace Community Webinar Series
Hot Topics: The DuraSpace
Community Webinar Series
Series Fifteen:
Introducing DSpace 7:
Next Generation UI

Hot Topics: The DuraSpace
Community Webinar Series
Curated by Claire Knowles,
Library Digital Development Manager,
The University of Edinburgh

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

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 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

DCAT
Co-Chairs
Bram Luyten, Atmire
bram@atmire.com
Maureen Walsh, The Ohio State University
walsh.260@osu.edu
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 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

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
Stackoverflow
http://stackoverflow.com/questions/tagged/dspace

http://stackoverflow.com/questions/tagged/dspace

http://stackoverflow.com/questi
ons/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+Amb
assador+Program
Conferences and User Groups
• https://wiki.duraspace.org/display/DSPACE/Conferences

Squashing bugs & Development
DuraSpace JIRA
http://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-low-hanging-fruit

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!

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

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.

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.

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

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: 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

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 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

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

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

3.15.17 DSpace: How to Contribute Webinar Slides

Recommended

Recommended

More Related Content

What's hot

What's hot (18)

Viewers also liked

Viewers also liked (9)

Similar to 3.15.17 DSpace: How to Contribute Webinar Slides

Similar to 3.15.17 DSpace: How to Contribute Webinar Slides (20)

More from DuraSpace

More from DuraSpace (20)

Recently uploaded

Recently uploaded (20)

3.15.17 DSpace: How to Contribute Webinar Slides