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

Duplicate content: Submission guidelines as PDF and in Wiki #152

Closed
k00ni opened this issue Jul 30, 2020 · 2 comments
Closed

Duplicate content: Submission guidelines as PDF and in Wiki #152

k00ni opened this issue Jul 30, 2020 · 2 comments
Labels
release:3.0.0 https://semiceu.github.io/DCAT-AP/releases/3.0.0

Comments

@k00ni
Copy link

k00ni commented Jul 30, 2020

Submission guidelines information is located both in PDF (https://github.com/SEMICeu/DCAT-AP/blob/master/DCAT-AP_Issue_submission_guidelines_v0.01.pdf) and in the wiki (https://github.com/SEMICeu/DCAT-AP/wiki/Submission-guidelines).

Are you open to only use one document containing this information?

Using PDF files could make it harder for people using accessibility technology to access information (e.g. https://accessibility.psu.edu/pdf/pdfissues/). Another reason against it is that Github users can't contribute to the PDF file because its considered a binary.

Using the wiki might also not be the right place. The wiki is only accessible via Github, but it seems this repository is also used in other places.

Therefore I would argue that a simple Markdown/Textfile should be enough. When its Markdown the file is rendered via Github and could almost look as nice as the current PDF. Also it allows contributions by others.

What do you think?

@bertvannuffelen
Copy link
Contributor

@k00ni thank you for the comment. We will take that in the current activity to improve the presence and management of the Core Vocabularies.

@bertvannuffelen
Copy link
Contributor

SEMIC is continuously improving its process and followup of the issues, governance and the publication of the specifications.
In the past years, the community has found its way to GitHub for reporting comments and participating in discussions.
With the publication of the specifications in HTML as main human readable format, this path will continued, working towards an open easy accessible place.

@bertvannuffelen bertvannuffelen added release:3.0.0 https://semiceu.github.io/DCAT-AP/releases/3.0.0 and removed component:documentation labels Jun 21, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release:3.0.0 https://semiceu.github.io/DCAT-AP/releases/3.0.0
Projects
None yet
Development

No branches or pull requests

2 participants