Wikidata:WikiProject Scholia/Robustifying/Documentation
Documentation of Scholia is the available information which enables anyone to use or contribute to Scholia. Scholia is a tool for end users, and it is also a crowdsourced project which accepts user generated content.
Key documentation[edit]
- Scholia documentation tickets in GitHub
- About Scholia
- Scholia, the live tool running on the Wikimedia Toolforge
- Wikidata:Scholia, the project page in Wikidata
- Wikidata talk:Scholia, the main forum for user comments
- Scholia, the project in GitHub
- @wdscholia, the Twitter profile
- Closely related
Documentation goals for 2020[edit]
Documentation of Scholia's content, code, and user instructions is significant beyond Scholia and models and teaches the concept of openness in general. By prioritizing documentation, we also establish a historical record of values. Universities, libraries, and the public should expect and protect the level of transparency, accessibility, and openness for which we are setting a standard. Our documentation priorities include routine usage instructions, lay and accessible interpretations of visualizations, notes on the underlying queries and data sources, and statements about gaps and biases.—Scholia team, Robustifying Scholia, 2019
Milestones[edit]
- GitHub label for documentation-related tickets
- GitHub project dedicated to documentation
- Wikidata:Scholia as a product page
- Wikidata:WikiProject Scholia as a community project
- CONTRIBUTING.rst at GitHub (Freddie)
- Wikidata:WikiProject Limits of Wikidata
- Lots of dispersed discussions, notes and partial summaries, e.g.
- https://wikitech.wikimedia.org/wiki/WMDE/Wikidata and subpages, e.g. for Wikidata Growth and Scaling
- Good first issue tags triggered by Hacktoberfest
2019 update[edit]
This project has been creating documentation and observing that the documentation already has an audience and people responding to it. The code is at GitHub and prose documentation is on the Scholia project page in Wikidata. Showcase developments include improving the CONTRIBUTING.rst file of the GitHub repository, the development of documentation of the Limits of Wikidata, prototyping some journal-level quality control of metadata.
Scholia is a tool in itself, but like so many other projects in the Open Data Commons, it is also a model for good behavior which other projects copy for practices in crowdsourced contributions. The audience for Scholia documentation includes Scholia users, anyone who looks to Wikipedia or Wikidata for data management precedent, the many organizations which want crowdsourced curated data about themselves, and many general aggregators. Since the project's start we already have communication with general Internet audiences that they examine the documentation and we have pageview metrics of documentation readers. This project is developing the documentation in anticipation that it also is useful in promoting community code development, open data curation, open project communication.
Still left to do is publish credit to 100+ key project contributors to date, convert timelines and incremental developments into a human readable narrative, and balance the potentially hundreds of pages of notes against a tighter plan for archival accessibility. Based on the precedent of reuse of Wikimedia systems, this project team expects later reuse of this project's methods in similar crowdsourced data and visualization projects.
Notes[edit]
- We started
- Wikidata:WikiProject Limits of Wikidata, as this discussion is highly relevant to how Scholia can develop
- Wikidata:Property proposal/Alfred P. Sloan Foundation Grant ID
- A separate Wikibase instance (based on WbStack) for experimentation