CKAN: Ticket #1400: Document Archiver Extension

owner, status, milestone changed

rgrp — Mon, 06 Feb 2012 11:50:13 GMT

owner changed from kindly to johnglover
status changed from new to assigned
milestone changed from ckan-v1.6 to current-ckan-sprint-2012-02-20

John: can you comment on status here. Have you already got docs for this?

johnglover — Tue, 07 Feb 2012 10:56:49 GMT

I haven't written any docs for this. I'm also not sure what the status is, Ross was doing some work on it recently so he is probably the man to ask.

priority changed

rgrp — Mon, 20 Feb 2012 09:20:53 GMT

priority changed from awaiting triage to major

@johnglover: I don't think Ross has done much here and he's obviously occupied with DGU at ;-) As you worked on this earlier would be able to look at this and a) check what docs there are b) add to them as necessary :-)

milestone changed; keywords set

johnglover — Mon, 20 Feb 2012 13:55:31 GMT

keywords 0.5d added
milestone changed from current-ckan-sprint-2012-02-20 to ckan-sprint-2012-03-05

Will document and update wiki this sprint then ping Mark about a blog post.

status changed; resolution set

johnglover — Wed, 29 Feb 2012 14:09:46 GMT

status changed from assigned to closed
resolution set to fixed

Async task docs are at: http://wiki.ckan.org/Writing_asynchronous_tasks Archiver readme at: http://github.com/okfn/ckanext-archiver

Emailing Mark RE blog post.

rgrp — Sun, 11 Mar 2012 15:57:41 GMT

Great to see this is done. I do have one question: why did we put this on the wiki rather than in the proper CKAN docs? In general, I think it would be better to use the wiki less and our proper docs more ...

johnglover — Mon, 12 Mar 2012 09:19:01 GMT

I thought that we had some sort of consensus that the official docs were aimed more at system admins and people using the CKAN WUI/API, with the wiki aimed more at developers? It would be easy to move of course, but there is no real "developers" section in the official docs that I can see, and it's even called "CKAN's Administration Guide".

rgrp — Mon, 12 Mar 2012 09:28:05 GMT

Hmmm. Emerging consensus from discussions in last few months is that wiki is fairly confusing and we should move core, solid docs (from whichever area) to the main docs.

Furthermore, key dev info like how to setup and do extensions *is* already in the main docs (see http://docs.ckan.org/en/latest/writing-extensions.html) and has been for 6m+. I've created #2226 for more work on docs and you may wish to comment there.

johnglover — Mon, 12 Mar 2012 09:33:36 GMT

I'll have a look thanks. I'm +1 on using main docs instead (if we move everything), I was just trying to keep things consistent for now.