Documentation: Very basic intro doc for Islandora CLAW

Created on 24 May 2016 · 7Comments · Source: Islandora/documentation

We have a lot of great material, but it's mostly written for a fairly technical audience. I've been asked for a simple, admin-oriented "What the heck is Islandora CLAW?" doc that we can point people to when they just plain want to find out what the project is and why we're doing it.

Got a bit of a start here: https://github.com/manez/CLAW/blob/master/docs/user-documentation/intro-to-claw.md

For the time being, @DiegoPino 's lobster chimera seemed like the most 'accurate' diagram to throw at a beginner 😄

Also going to cover:

Why Fedora 4 over Fedora 3
Drupal 8?
more?

Looking for ideas on what to include.

documentation

Source

manez

👍4

All 7 comments

Looking good @manez!

Why Fedora 4 over Fedora 3
Drupal 8?
Community developed
Project plan
RDF metadata
LDP
... will think more

ruebot on 24 May 2016

😄1

Ah yes, RDF and LDP. Not my strong suit, but should be in there.

manez on 26 May 2016

👍1

Partially addressed with https://github.com/Islandora-CLAW/CLAW/commit/4075a072b69d162cedfc2cb6af6f557e814d7a07

ruebot on 26 May 2016

@manez some feedback from #fcrepo channel (@awoods)

10:10:36 < awoods> ruebot: This picture seems misleading: https://github.com/Islandora-CLAW/CLAW/blob/master/docs/user-documentation/intro-to-claw.md#what-is-islandora-claw
10:11:24 < awoods> ruebot: It is confusing to see the title: "What is Islandora CLAW?" followed by a picture that shows Fedora 3.8.1
10:12:29 < ajs6f> ruebot: Also, there doesn't appear to be any meat patty in that hamburger. It's just mustard, ketchup, and lettuce.
10:13:04 < awoods> ajs6f; good point... where's the beef?!
10:13:22 < bseeger> awoods: or seafood… it is claw

ruebot on 27 May 2016

@ruebot, not sure if they only looked at the images without the text, but I do have some spare Sharpies i can share to fix it 😄 but burger(and yes, no explicit meat, red can be meat depending on your own experience there are some not meat eaters in the world!) reads to 7.x-1.x.