Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Host SDD primer again #487

Open
larsgw opened this issue Feb 2, 2023 · 5 comments
Open

Host SDD primer again #487

larsgw opened this issue Feb 2, 2023 · 5 comments

Comments

@larsgw
Copy link

larsgw commented Feb 2, 2023

I was wondering if there was interest to host the SDD primer again. It's currently archived in the twiki format (e.g. https://github.com/tdwg/wiki-archive/tree/master/twiki/data/SDD/Primer), but this is difficult to read, especially the tables and images. I made a script to convert the twiki content to HTML for personal use (https://larsgw.github.io/tdwg-wiki-archive/SDD/Primer/SddIntroduction.html). Is there interest for me to clean up that HTML (some links are broken) and host it here?

@stanblum
Copy link
Member

stanblum commented Feb 2, 2023 via email

@larsgw
Copy link
Author

larsgw commented Feb 2, 2023

Hi Stan,

The more appropriate place is probably the SDD GitHub repository. We could put a link to it on the SDD landing page, which is on the TDWG website. Would that be acceptable?

Yes, definitely.

I'm curious about your interest in SDD.

I am working on a platform for curating a collection of identification keys and similar resources (https://identification-resources.github.io/). I am already using Darwin Core for data on the taxonomic scope of the keys. In some cases I would like to save keys in a standard format for archival and display, especially those that are hard to access otherwise.

Are you using it yourself (and how?), and are you aware of others who are using it?

I know that Xper³ uses a modified version of SDD for their identification key platform. Personally, I recently used SDD when helping an organization recover an interactive multi-access key from an old relational database that they could no longer run, and I delivered this as an SDD file compatible with Xper³. However, I ran into some limitations of the format (mostly missing characteristic types for spatial and temporal data), and I feel like there's good potential to make SDD more interoperable with other TDWG standards such as Darwin Core.

Last, is the script you wrote "generic", in that we could run it on other content that we "lost" when the Twiki collapsed? What is the script written in?

Yes, the other content is also online but generally contains more errors (e.g. https://larsgw.github.io/tdwg-wiki-archive/Main/BioBlitz2010). I can work on refining the script some more. It is written in JavaScript (source) and also uses a GitHub Actions workflow to copy static files (source).

@stanblum
Copy link
Member

stanblum commented Feb 2, 2023 via email

@baskaufs
Copy link
Contributor

baskaufs commented Feb 2, 2023

Hi Stan and Lars,

What needs to happen is for the generated HTML to be put some stable place where it’s going to get rendered into a GitHub pages web page. If it just gets put into the code of the SDD repository without that repository being set up with GitHub pages, it won’t be rendered as a web page. People will just see the HTML markup.

@peterdesmet would it make sense to just enable GitHub Pages for the SDD repo and have it point to a docs directory or something. The generated HTML page could be the only thing that lives there. Once it's getting rendered, it could be linked from the Standards landing page as Stan suggested.

@stanblum
Copy link
Member

stanblum commented Feb 2, 2023 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants