search

ivoa / ivoa-web

ivoa.net website static web pages
Creative Commons Attribution Share Alike 4.0 International
3 stars 2 forks source link

Code of conduct should have a page rather than a PDF #53

Open JeremyMcCormick opened 2 months ago

JeremyMcCormick commented 2 months ago

It would be better to have a dedicated page for the code of conduct rather than a PDF.

gmantele commented 2 months ago

That should probably decided by TCG/Exec as it came originally from them. There maybe be a reason to have it as a PDF instead of an HTML page (e.g. easy to download, 1 version = 1 file with an explicit date while a date in an HTML page might not be up-to-date, ....). If no reason at all, why not having it as a page on the website.

Zarquan commented 2 months ago

We made a start on putting the IVOA code of conduct in version control, but it hasn't been approved by the exec yet. https://github.com/ivoa/CodeOfConduct/

It contains an mark down version here: https://github.com/ivoa/CodeOfConduct/blob/main/CODE_OF_CONDUCT.md

JeremyMcCormick commented 2 months ago

Depending on preference, we could keep it as a PDF or link to the markdown file in the other project.

It would be fairly typical on other similar sites to have the Code of Conduct as part of the HTML site content and not an external document.

molinaro-m commented 2 months ago

The reason for PDF I think is to have an "fixed" CoC while the other solutions are easily modifiable, version control or not in place. To me the solution would be a markdown one (maybe coming from Dave's repo, if Exec complies) with a visible link to the Exec approved PDF. It's more things to maintain, but in the end it only requires checking coc.md.isequal(coc.pdf.innertext) = T.