vmbrasseur / ias3api Goto Github PK

The original HTML file should be added to the repo, both for reference & posterity.

Summary.md says there are 10PB at IA. That's out of date by at least a couple of petabytes.

Hi, just wondering how to use non-ASCII characters as metadata https://github.com/vmbrasseur/IAS3API/blob/master/metadata.md, since HTTP restricts header values to ISO-8859-1.
I guess you can use Unicode if you set metadata via files?https://github.com/vmbrasseur/IAS3API/blob/master/metadatafiles.md

All of the external links in this doc harken from 2011.

It'd be wise to take a pass through each doc to confirm that all of these links still work and, if not, replace them with ones which do.

Add a page which lists the other IA tools: Jake's Python script/library, the metadata API, torrents for downloads.

• Populate it with the people who have contributed so far.
• Add updating it to the Contributing.md file

There's a doc for contributors, but not for HOW one goes about contributing.

Fix that.

There's no single, "And here's what you can do with this API..." blurb anywhere.

Add this, either to the README, the introduction, or both.

This wasn't in the original doc, so there's no content for it yet.

Write this.

This wasn't in the original doc, so there's no content here.

Add this.

Reported by @TardisPackrat via email:

On https://github.com/vmbrasseur/IAS3API/blob/master/examples/curl-create_video_item_with_metadata.md should the code example be formatted? Looks... off.
Ditto: https://github.com/vmbrasseur/IAS3API/blob/master/examples/curl-update_metadata.md
And again: https://github.com/vmbrasseur/IAS3API/blob/master/examples/curl-upload_text_item.md
And again: https://github.com/vmbrasseur/IAS3API/blob/master/examples/curl-upload_to_existing_item.md
And again: https://github.com/vmbrasseur/IAS3API/blob/master/examples/curl-upload_video_item.md
And again: https://github.com/vmbrasseur/IAS3API/blob/master/examples/curl-upload_video_with_metadata.md

Huh. Not sure what happened there. I'll have a look.

Right now the document is relying upon Github's markdown processing/display.

Eventually, may want to consider other options, if only leveraging the theme-ability of github.io.

For S3, things usually aaaaaaaall go into one bucket.

You shouldn't do that for IA. Create items for logical groupings of things.

This didn't exist in the original doc, so there's no content for it yet.

Write this up.

SSIA.

I renamed the xml/mrc files in the appendix to .md to give more control over formatting.

Unfortunately, these are linked elsewhere in the documentation.

Gotta fix those links.

In the Amazon S3 Headers of the headers documentation, x-amz-auto-make-bucket is mentioned. In the following paragraphs, another header x-archive-auto-make-bucket is described. The first one begins x-amz and the second x-archive. Is this a typo? Should these two headers be the same?

i have read examples/curl-update_metadata.md and tried:

$ curl --location
--header 'x-archive-ignore-preexisting-bucket:1'
--header 'x-archive-meta01-collection:opensource'
--header 'x-archive-meta-mediatype:software'
--header 'authorization: LOW myaccesskey:mysecretkey'
--upload-file /dev/null
http://s3.us.archive.org/lxfrudvd180
but received "411 Length Required" error ("A request of the requested method PUT requires a valid Content-length.").

i tried to add a header "Content-Length:0", but the error is the same.

The IA donation link should be present in this doc. Add it to:

• README.md
• SUPPORT.md
• contributors.md
• othertools.md

In the Code Examples section, add example code for:

• using boto
• using ia-wrapper

(I will do this and send a pull request later this week)

Refactor the support stuff off ./README.md into it's own page. Link to it from README.md (and elsewhere if necessary).

There are three pages without content. They should at the very least reference the Github issues for that missing content.