Giter VIP home page Giter VIP logo

lc-wikidata's Introduction

Maintainers for Library Carpentry: Wikidata

Lesson Maintainers communication is via the team site.

Library Carpentry

Library Carpentry is a software and data skills training programme for people working in library- and information-related roles. It builds on the work of Software Carpentry and Data Carpentry. Library Carpentry is an official Lesson Program of The Carpentries.

License

All Software, Data, and Library Carpentry instructional material is made available under the Creative Commons Attribution license.

Contributing

There are many ways to discuss and contribute to Library Carpentry lessons. Visit the lesson discussion page to learn more. Also see Contributing.

Code of Conduct

All participants should agree to abide by The Carpentries Code of Conduct.

Authors

Library Carpentry is authored and maintained through issues, commits, and pull requests from the community.

Citation

Cite as:

Library Carpentry: Wikidata. September 2019. https://librarycarpentry.org/lc-wikidata.

Checking and Previewing the Lesson

To check and preview a lesson locally, see http://carpentries.github.io/lesson-example/07-checking/index.html.

lc-wikidata's People

Contributors

aaouinaa avatar arindam-halder avatar brandonkatzir avatar elhossary avatar hthorsen avatar kayakr avatar konrad avatar nici142 avatar peggygriesinger avatar rabeamue avatar tillsa avatar yclepit avatar zkamvar avatar zuphilip avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

lc-wikidata's Issues

Episode 05 - change the example

Change the example from Richard Feynmann to an example of showing all books from one author

  • maybe choose another author (e.g. Albert Einstein)

Automate screenshot taking

This has IMO low priority but it would be great if we could automate the screenshot generation e.g. using Selenium. It would make it more reproducible and speed up things on the long run.

Episode 03 3.3 focus on Mae Jemison rather than book?

While looking at adapting the current example (Feynman and one of his books) to use Mae Jemison and one her books, I'm wondering whether it might make more sense to add detailed steps for describing the first item (Mae Jemison) rather than the second one (her book), for two reasons:

  1. It seems weird to not add an instance and at least one profession based on Jemison's Wikipedia entry, which would also be easy to add as a reference. (Her memoir doesn't have a Wikipedia entry and describing it, with references, would require the learner to look for external sources, which doesn't seem to be the emphasis of this exercise.)
  2. Describing the book would require delving into more complex modeling (is it an instance of "book" or "written work" or "version, edition, or translation"?
    See https://www.wikidata.org/wiki/Wikidata:WikiProject_Books

Brief explanation of SPARQL in intro

The episode 01 intro includes this sentence: "The data can be queried with SPARQL which will be covered later." I suggest we briefly explain what SPARQL is, even if it just to call it the SPARQL querying language, so that participants who have never heard of SPARQL have at least some context at this point - is it a tool? a script?, etc. I know it gets explained in depth later, but I could see this intimidating people who have never heard of it - because it's not explained even a little (outside of the verb queried), there could be an assumption that people should know what SPARQL is already.

registration

participants need to be registrated in wikidata for four days to be able to edit wikidata items.
Add information to instrutor notes

Links need to be fixed in CONTRIBUTING.md

The Contributing Guide, CONTRIBUTING.md, contains two links with URLs that should be updated:

  1. the How to Contribute to an Open Source Project on GitHub link leads to a 404 and should be updated to link to https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github
  2. the [repo] link reference currently points to a placeholder URL (https://example.com/FIXME) and should be updated to point to the source repository for the lesson (i.e. this GitHub repository).

The Contributing Guide is one of the files that is unique to each repository - to allow for individual lesson projects to define their own guidance for contributors - so unfortunately this is not an issue that can be fixed centrally e.g. by updating the template files in the lesson infrastructure. Instead the file must be updated in the individual lesson repositories themselves.

Small suggestions for 1.1 and 1.2

I recently completed my Library Carpentries training course with a view to helping out and contributing to Wiki-based lessons specifically. Is this one still in development? I would be really happy to help get it over the finish line. I apologise if this lands in the wrong area.

In terms of suggestions, I wonder if 1.1 could utilise just one example plus visual: at the moment we read about one (the Library) but see the described terms on another (Douglas Adams). In 1.2, we ask for participants to look up their home city: maybe country would be better, as this will cover a wider range of possibilities.

These are small things and by no means urgent! I'd love to carry on the conversation around this module, I'm [email protected], currently Wikimedian in Residence at the British Library.

Exercise that teaches how to create a new item and a new statement?

One exercise of the LC is supposed to contain a task where learners create a new item on Wikidata and add a new statement to an already existing item. The issue that we face right now is which kind of items we should chose. The items/entities need to meet some criteria:

  • have something to do with libraries
  • don't exist yet
  • have enough relevance, so they won't be deleted by other people after the lesson
  • can be updated automatically (by a bot)

Alternatively we can use the Wikidata Sandbox. But creating items in the "real world" of Wikidata is preferable. If you have any ideas please share them :)

Should we add the LOD cloud?

The Linked Open Data Cloud is a good visualization of the state of LOD and could help to understand the underlying purpose of a knowledge graph. It could fit in figure 2. It is CC-BY licensed. One issue is that it is updated regularly.

alt text

Scheduling early transition to Workbench

Short version: are you are willing to volunteer your lesson for early transition to The Carpentries Workbench
infrastructure?


Longer version below:

As I hope you are already aware, @zkamvar and the rest of the Curriculum Team are preparing to roll out the new lesson infrastructure, The Carpentries Workbench, across all of The Carpentries official lessons in early May 2023. This means that all Data Carpentry, Library Carpentry, and Software Carpentry lesson repositories will be modified to adopt the new infrastructure at the end of this month.

As you might imagine, coordinating a rollout like this involves a large amount of time and effort, and one thing that will really help us to keep to the schedule and avoid disruption for the community is to be able to prepare some lessons for
transition before the 1st May deadline
.

With this in mind, I invite you to volunteer to schedule an early transition for theis lesson repository. If you expect to have time to adopt the Workbench version of the lesson repository in the next couple of weeks, please reply to let me know. As lesson Maintainers, these are the things you will need to be prepared to do for the transition:

  1. Be prepared to quickly merge pull requests from Zhian. These pull requests will help update the lesson and aid the transition process.
  2. Close any outstanding pull requests. Your repository currently has very few or zero open PRs, but we cannot rule out the possibility that someone will open more in the time between now and when the transition takes place. Open PRs will be invalidated when the transition takes place.
  3. Preview the lesson (in the https://github.com/fishtree-attempt organisation) when it is available. Zhian will open an issue in your repository, tagging you when the preview is available. You should reply on that issue if you notice any problems with the Workbench version of the lesson site and repository in the preview.
  4. Just before the transition happens, the repository will be temporarily set as read-only and an issue will be opened (see an example from the Maintainer Onboarding curriculum: carpentries/maintainer-onboarding#69)
  5. After the transition, delete and recreate any forks and local clones you have of the repository and then confirm that you have done so (you will be given specific instructions in an issue).

If you are willing and able to help us ensure a smooth rollout of the Workbench, please reply to let me know that you are happy to volunteer your lesson for early transition. If there is a specific date you would like the transition to take place (or that we should avoid), please also mention that.

two options for example in episode 3

The books as an example are not that easy in case of data models and good pracitce.
Suggestion is to use new research articles in the real wikidata instance instead.

  • add research article example in episode 3 as an alternative option
  • mention the two different options in the instructor notes

motivation to use wikidata

add motivation and "why" to use wikidata as one topic.
Especially why to use an librarian

  • maybe also through real case (e.g. scholia)

Wikidata, WikiData, wikidata

We currently have different writings for "Wikidata":

  1. Wikidata (as it is also written in Wikidata, see Q2013)
  2. WikiData
  3. wikidata

Can we be more consistent and use always the first one? I.e. use an upper-case "W" but everything else lower-case. The links to Wikidata should stay all-lowercase as usual.

Lesson 01 1.3 Relationship with other wiki projects: distinguish Wikidata from Dbpedia?

Might it be useful to briefly state that Wikidata is not Dbpedia? I have, anecdotally, seen this cause confusion among librarians. Making distinctions between the goals of the two projects (and where they overlap) might also help participants to understand the relationship between Wikidata and Wikipedia. (Apologies if this idea has already been discussed.)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.