Hi everyone,
This post will combine a few interrelated topics: 1) update on the documentation coming out of the design project with our Outreachy intern @Lydiaofficial; 2) some ideas for general restructuring of the Documentation section of the website with a view on highlighting contribution how-tos (related also to this topic); and 3) some recommendations for the general OpenRefine website, which we received from our consultation with designers from https://opensourcedesign.net/
-
@Lydiaofficial has been busy over the last few weeks on cleaning up the design system documentation in Figma (more on that soon) and preparing a document for how designers can contribute to the project that can be inserted in the Documentation space on OpenRefine's website. The draft document is here: Design contributions Doc - Google Docs So far it includes a short intro and a ToC, which Lydia will work to fill out this week & next. Any input on the general structure and if we're missing any important points is welcome!
-
In order to fit this dedicated 'contributions for designers' doc in an appropriate place on the public OpenRefine documentation site, I'd like to propose the following slight overall restructuring.
Current structure:
- User manual
- Grel reference
- Technical reference
** Contributing to OpenRefine
** Architecture
** Extensions
** Maintaining OpenRefine
New structure:
- User manual
- Grel reference
- Technical reference
** Architecture
** Extensions
** Maintaining OpenRefine - Contributing to OpenRefine
** As a developer
** As a designer
** As a user
The idea of this new structure is to bring out contributing more prominently and allow a new sub-structure depending on the type of contributor.
- Talking to Jan Diettrich and Django Scorupa from the open source design community last Friday, we got positive feedback on our approach so far, with Jan committing to support the editing and final review of text for the document shared in 1) above, and with Django volunteering to support the final version of the design system documentation in Figma.
Speaking to them about the placement of the documentation within the overall OpenRefine site, they pointed out that to recruit more designers onto the project two important aspects need to be addressed:
- Making it obvious who are the users of this project and why we (designers) should be excited about helping these users. A simple and elegant solution here would be to feature at least 3 use case studies on the main homepage - either above or below the 'main features' section; eg case study with data journalism; with science data; and with GLAM data. The case studies themselves can be shown as cards (similar to the main features) which upon click open to new pages with short texts and 1-2 images. It would be particularly impressive if we can include some logos of major institutions using OR, either within the case studies, or just as a separate mini section on the homepage, I've seen this on other OSS projects - it just lends legitimacy and makes it more desirable to be part of the team, if like the National Libraries of such and such country are using this, or this and that major journalistic outfit, etc.
- Making it more easy to directly jump to the 'how to contribute' sections in the documentation part of the site. It's great we have the 'Get involved' link in the footer, but it could be make more prominent with a direct call to action within the content area of the homepage. Just an example of one OSS project that has nice sectioning on the homepage is this: https://processing.org/ (but there are loads of other good examples, too).
All feedback welcome!