search

bagit-profiles / bagit-profiles-specification

https://bagit-profiles.github.io/bagit-profiles-specification/
Other
35 stars 11 forks source link

Move the README to respec? #15

Closed ruebot closed 4 years ago

ruebot commented 5 years ago

I was looking through the spec again, and looking for SHOULD, MUST, and realized when we wrote this long ago, neither of us had any respec experience. I have that now from working on the Fedora spec. So, should we move the README to respec? If so, I'm happy to take it on, and setup GitHub pages for the repo to publish it there.

mjordan commented 5 years ago

If we went to respec, would our spec look like https://fedora.info/2018/06/25/spec/ ? If so, where would we publish it?

kba commented 5 years ago

You could create a Github Pages site for the organization bagit-profiles, the spec could live at https://bagit-profiles.github.io/<version>/

I would appreciate a more formal spec and can also help with that (though I know bikeshed better than respec).

In addition to the contents of the README, I'd find it useful to have an informal "Implementation Report"-like section with samples used in the wild.

ruebot commented 5 years ago

I'm cool with Bikeshed. I'll start a branch later today or tomorrow, and we can start hacking away at it there.

ruebot commented 5 years ago

@mjordan yeah, it'd be what @kba said: https://bagit-profiles.github.io//

ruebot commented 4 years ago

Onec we sort out the current two PRs (#21 and #20), I'll incorporate their outcomes into the respec branch, merge that into master, and publish it with gh-pages.

ruebot commented 4 years ago

Resolved with https://github.com/bagit-profiles/bagit-profiles-specification/commit/85937898f0ca1833e9b745ef88eea9c78c638ae5