From: Larry Stone <lcs@mi...> - 2008-07-21 21:07:25
There _was_ documentation for the venerable batch importer in the
HTML pages in the docs subdirectory; in a source checkout, it's at
the relative path:
(I can't get the location in the Subversion repository because
Sourceforge seems to be having a bad hair day..)
Your new PDF document is better -- could you at least put it up on the
wiki for how?
The default METS SIP (Submission Information Package) accepted by the package
ingester is also mentioned in the HTML docs:
but the link to a document describing the METS SIP profile is broken:
There _is_ a page about it on the WIKI, although it could use some cleanup:
It could use an annotated example of a complete submission package, I
think that would be the most helpful part for anyone putting their own
SIPs together. (They should also see the "DSpace SIP Toolkit" wiki page)
> It's a funny thing, the DSpace Batch Import Format (of which there are
> two) are not documented anywhere other than looking at the source
> code. We've run across the situation where a department has some
> content to put into the repository and the resources to create a batch
> import, but just don't know how to do it. To solve this problem, we've
> created a simple hand out to provide to a programmer or technical
> person in another department or group when they want to develop their
> own batch import script. While it doesn't cover the advanced topics,
> like registering bitstreams etc, nor dose it go over the package
> importer, it should solve the problem for the vast majority of cases
> where someone needs to create a batch import.
> I thought this might be useful to others out there, the only other
> resource on creating batch imports I was able to find is Dorothea's
> blog: http://cavlec.yarinareth.net/2008/01/07/the-dspace-batch-
> Here is our handout:
> This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
> Build the coolest Linux based applications with Moblin SDK & win great prizes
> Grand prize is a trip for two to an Open Source event anywhere in the world
> Dspace-devel mailing list
From: Larry Stone <lcs@mi...> - 2008-07-25 22:29:42
While we're talking about the fate of DSpace documentation,
I'd like to put in a plea to maintain a Web-friendly version *as well*.
When consulting the doc for other open-source projects (usually because
they are components of DSpace..) I find the online HTML version of
the doc a lot more handy than PDF: it's easier to navigate, faster
to get to, easier to read on a computer display.
PDF is a whole lot better suited to printing than to viewing online.
The PostgreSQL site is an excellent example of an online manual --
Note that it also has a place to attach "user comments" (along the
lines of a blog). These often have very useful hints and tidbits.