From 5480cf0c930de13eeece0d65dda1de2ce122b850 Mon Sep 17 00:00:00 2001 From: Lars Holm Nielsen Date: Mon, 1 Jul 2024 15:17:22 +0200 Subject: [PATCH] help: move faq to zammad --- content/help/contents.lr | 62 ++++++++- content/help/faq/citations/contents.lr | 162 +----------------------- content/help/faq/contents.lr | 59 ++++++++- content/help/faq/general/contents.lr | 114 +---------------- content/help/faq/github/contents.lr | 50 +------- content/help/faq/openaire/contents.lr | 93 +------------- content/help/faq/policies/contents.lr | 78 +----------- content/help/faq/security/contents.lr | 25 +--- content/help/faq/statistics/contents.lr | 150 +--------------------- content/help/faq/technical/contents.lr | 30 +---- content/help/faq/versioning/contents.lr | 111 +--------------- templates/blocks/sectionindex.html | 9 ++ templates/faq.html | 2 + 13 files changed, 181 insertions(+), 764 deletions(-) diff --git a/content/help/contents.lr b/content/help/contents.lr index b71dee7..d0665ae 100644 --- a/content/help/contents.lr +++ b/content/help/contents.lr @@ -18,9 +18,65 @@ title: Frequently Asked Questions ---- body: -**Tip**: See also the [OpenAIRE FAQ](https://www.openaire.eu/faqs) for general information on Open Science and European Commission funded research. ----- -menu: /help/faq + +
+
+
+ +

Search FAQ

+ +
+
+
+ +
+
+

General

+
+
+

Account

+
+
+

Upload/Deposit

+
+
+

Collaborate and share

+
+
+
+
+

Communities

+
+
+

Usage statistics

+
+
+

Citations

+
+
+

Safelisting

+
+
+
+
+

GitHub integration

+
+
+

Policies

+
+
+

Reuse

+
+
+
+
+ +**Tip**: OpenAIRE provides general guides/training on open science, Horizon Europe, research data management (RDM) and legal issues for researchers: + +- [Guides](https://www.openaire.eu/guides) +- [Webinars](https://www.openaire.eu/support/webinars) +- [Open science in Europe](https://www.openaire.eu/open-science-europe-overview) + #### sectionindex #### title: Docs ---- diff --git a/content/help/faq/citations/contents.lr b/content/help/faq/citations/contents.lr index 2fce489..46bc9ee 100644 --- a/content/help/faq/citations/contents.lr +++ b/content/help/faq/citations/contents.lr @@ -4,160 +4,10 @@ title: Citations --- sort_key: 10 --- -faqlist: - - -#### qaitem #### -question: Can I sort search results by most cited? ----- -answer: No, however we do plan to make this possible. ----- -category: citations-col1 -#### qaitem #### -question: Which citations are shown on my record? ----- -answer: - -We by default roll-up citations to **all versions** of your record in order to show its full impact. - -You can however use the filter "Citations to this version" to show only citations to the specific version of a record you are viewing. ----- -category: citations-col1 -#### qaitem #### -question: Which records show citations? ----- -answer: We display citations, if available, for all records in Zenodo. ----- -category: citations-col1 -#### qaitem #### -question: Why does my record not show any citations? ----- -answer: - -Your record might not show any citations because: - -1. The record has not yet been cited. -2. The citations to your record have not yet been discovered by any of our citation data sources. -3. The domain of your record is not covered by any of our citation data sources. -4. The citations are not freely available. ----- -category: citations-col1 -#### qaitem #### -question: In which domains do you have good citation data coverage? ----- -answer: - -Currently (January 2019) we primarily cover astronomy and astrophysics. - -We also receive citation data from cross-domain citation data sources, however often the coverage is not good as it relies on publishers to make the citation data freely available (which some big publishers do not do). ----- -category: citations-col1 -#### qaitem #### -question: Who are your citation data sources? ----- -answer: - -We are currently receving citation data from: - -- [NASA Astrophysics Data System](https://ui.adsabs.harvard.edu/) (astronomy and astrophysics). -- [DataCite](https://www.datacite.org/eventdata.html) and [Crossref](https://www.eventdata.crossref.org/guide/index.html) Event Data (cross-domain) +toptext: -We plan to expand this list with further data sources. Do not hesitate to get in contact with us, if you are interested in becoming a citation data source. ----- -category: citations-col1 -#### qaitem #### -question: How many citations are available? ----- -answer: At launch (January 2019), around 2500 records have a minimum of one citation with a total of around 3500 total citations (about half from ADS and half from Crossref/DataCite Event Data). Only around 250 out of the 3500 citations are known by both systems. ----- -category: citations-col1 -#### qaitem #### -question: Why the beta label? ----- -answer: Currently our infrastructure is feature complete, however we are still expanding our citation data sources in order to have better coverage. We will remove the beta label as soon as we reached a better coverage. ----- -category: citations-col1 -#### qaitem #### -question: When do you expect to remove the beta label? ----- -answer: Working with citation data sources and checking the data quality takes time and thus we expect that we may stay in beta until first-half of 2020. ----- -category: citations-col1 -#### qaitem #### -question: How often are citations updated? ----- -answer: New citations from our citation data sources are made available minimum once a day. ----- -category: citations-col1 -#### qaitem #### -question: Which data source provided a specific citation? ----- -answer: Each citation shows a small question mark icon to the right, which if you hover the mouse over will display the tooltip containing the list of all data sources which provided the link. ----- -category: citations-col2 -#### qaitem #### -question: Do you deduplicate citations? ----- -answer: Yes. We may receive the same citation from multiple data sources. The deduplication is purely based on synonymous persistent identifiers. ----- -category: citations-col2 -#### qaitem #### -question: Can I manually add citations? ----- -answer: - -No, this is unfortunately not possible. We may allow this in the future but quality checking and spam detection make this non-trivial. - -If you run a discovery system with citation data you can however become a data source. [Contact us](https://zenodo.org/support) for further information. ----- -category: citations-col2 -#### qaitem #### -question: I found an wrong citation, what do I do? ----- -answer: Please [contact us](https://zenodo.org/support). ----- -category: citations-col2 -#### qaitem #### -question: Why does my citation not have a title? ----- -answer: We usually receive citation data as a link between two persistent identifiers (e.g. "DOI A cites DOI B") without any metadata. We therefore have to automatically retrieve metadata such as title, authors and publication year from other services. Sometimes this automatic fetching is not able to find any available metadata, in which case we only display the persistent identifier. ----- -category: citations-col2 -#### qaitem #### -question: Do you provide aggregated citation metrics for authors? ----- -answer: No. ----- -category: citations-col2 -#### qaitem #### -question: Do you provide aggregated citation metrics for communities? ----- -answer: No. ----- -category: citations-col2 -#### qaitem #### -question: Which system do you use for citation tracking? ----- -answer: - -Zenodo is using a citation brokering software built for the Asclepias project called [Asclepias Broker](https://asclepias-broker.readthedocs.io/). The software is open sourced under the MIT license. - -The Asclepias Broker exposes an API by which multiple citation data sources can send citation data in the [Scholix format](http://www.scholix.org/). ----- -category: citations-col2 -#### qaitem #### -question: What is The Asclepias Project? ----- -answer: - -Asclepias is an Alfred P. Sloan Foundation funded project to improve software citation across Astronomy. - -The goal is to promote scientific software into an identifiable, citable, and preservable object. The focus is on the needs of 1) authors of scholarly manuscripts and 2) developers of scientific software. - -The project partners include: - -- American Astronomical Society (AAS) -- NASA Astrophysics Data System (ADS) -- CERN (Zenodo) ----- -category: citations-col2 +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/contents.lr b/content/help/faq/contents.lr index bf034f3..fafc6c0 100644 --- a/content/help/faq/contents.lr +++ b/content/help/faq/contents.lr @@ -11,4 +11,61 @@ toptext: # Frequently Asked Questions
-**Tip**: See also the [OpenAIRE FAQ](https://www.openaire.eu/faqs) for general information on Open Science and European Commission funded research. + +
+
+
+ +

Search FAQ

+ +
+
+
+ +
+
+

General

+
+
+

Account

+
+
+

Upload/Deposit

+
+
+

Collaborate and share

+
+
+
+
+

Communities

+
+
+

Usage statistics

+
+
+

Citations

+
+
+

Safelisting

+
+
+
+
+

GitHub integration

+
+
+

Policies

+
+
+

Reuse

+
+
+
+
+ +**Tip**: OpenAIRE provides general guides/training on open science, Horizon Europe, research data management (RDM) and legal issues for researchers: + +- [Guides](https://www.openaire.eu/guides) +- [Webinars](https://www.openaire.eu/support/webinars) +- [Open science in Europe](https://www.openaire.eu/open-science-europe-overview) diff --git a/content/help/faq/general/contents.lr b/content/help/faq/general/contents.lr index b30bf04..3d70b94 100644 --- a/content/help/faq/general/contents.lr +++ b/content/help/faq/general/contents.lr @@ -4,113 +4,11 @@ title: General --- sort_key: 1 --- -faqlist: - -#### qaitem #### -question: Can I change files in an already published record? ----- -answer: - -Once the record has been published you can no longer change its files. Nonetheless, there are several options: -1. If the record has a Zenodo DOI (prefix: ``10.5281``): - * In most cases it is recommended to create a new version of a record ([more details](/faq/#versioning)). For example: modifications of the dataset/software, addition or removal of files, new versions of datasets, software or revisions of the papers, including major revisions as well typos and formatting/styling. - * Exceptionally, we allow small modifications to the record's files, if and only if the record was published recently (in the past month). If you have spotted mistakes such as typos, accidental omission of important files/inclusion of hidden files or confidential files and would like to update them, please contact us. -1. If the record has a non-Zenodo DOI: - * Since it is not possible to create new versions for non-Zenodo DOIs you should contact us about updating files directly. - -All file update requests need to be submitted through our [contact form](https://zenodo.org/support). - -Meeting the above points ensures that we can resolve your case faster. -Please note that we may reject your request if we deem that it is not a small change. ----- -category: general -#### qaitem #### -question: Why is my closed access upload not on the front-page? ----- -answer: - -Zenodo is a strong supporter of open data in all its forms (meaning data that anyone is free to use, reuse, and redistribute) and takes an incentive approach to encourage depositing under an open license. -We therefore only display Open Access uploads on the front-page. -Closed access uploads are still discoverable through search queries, its DOI, and any communities where it is included. ----- -category: general -#### qaitem #### -question: Why do you allow closed access uploads? ----- -answer: - -Since there isn't a unique way of licensing openly, nor a consensus on the practice of adding attribution restrictions, we accept data under a variety of licenses in order to be inclusive. -We will, however, take an active lead in signaling the extra benefits of the most open licenses, in terms of visibility and credit, and offer additional services and upload quotas on such data to encourage using them. -This follows naturally from the publications policy of the [OpenAIRE initiative](https://www.openaire.eu) which is a strong supporter of Open Access and allows submission of material that is not yet Open Access since it aims to gather all European Commission/European Research Area research results. ----- -category: general -#### qaitem #### -question: What happened to the OpenAIRE Orphan Record Repository? ----- -answer: +toptext: -OpenAIRE Orphan Record Repository got a make-over and was re-branded as Zenodo. -If you deposited your article in OpenAIRE Orphan Record Repository, it is also available in Zenodo. -However, your user account was not transferred to Zenodo, so you will have to [register](https://zenodo.org/signup/) again. -If you register with the same email address in Zenodo as you used in OpenAIRE Orphan Record Repository, you will still have access to your publications. -Don't hesitate to [contact us](https://about.zenodo.org/contact) for further information. ----- -category: general -#### qaitem #### -question: Where does the name come from? ----- -answer: Zenodo is derived from [Zenodotus](https://en.wikipedia.org/wiki/Zenodotus), the first librarian of the Ancient Library of Alexandria and father of the first recorded use of metadata, a landmark in library history. ----- -category: general -#### qaitem #### -question: How much digital storage-space does CERN have available? ----- -answer: - -Zenodo is currently a drop in the ocean. -CERN stores more than 100PB (petabytes) of physics data from the [Large Hadron Collider (LHC)](https://home.web.cern.ch/about/accelerators/large-hadron-collider), and produces roughly 25PB per year when the LHC is running. ----- -category: general -#### qaitem #### -question: Can I know the DOI of my record before publishing, so that I can include it in the paper or dataset? ----- -answer: - -Yes you can! On the upload page under *Basic Information* and *Digital Object Identifier* click the *Reserve DOI* button. -The text field above will display the DOI that your record will have once it is published. This will not register the DOI yet, nor will it publish your record (so you can still update the files). -This DOI can be safely used in the record's own content as well as any other separate datasets or papers you might be planning to publish. ----- -category: general -#### qaitem #### -question: How does Zenodo deal with spam content? ----- -answer: - -We have two primary methods in place for dealing with spam submissions (e.g. advertisements, scams): - -- An automated classification system that prevents identified uploads entirely from being published. This system is based on a model trained on past spam submissions labelled manually by Zenodo administrators. -- A human-based review of users that are added into a "safelist". Submissions from users that are added into the safelist, are ranked higher in all search results. ----- -category: general -#### qaitem #### -question: What are the criteria for a user to be added to the safelist? ----- -answer: Zenodo administrators add users to the safelist if their uploads comply with the service's [terms of use](https://about.zenodo.org/terms/) and [general policies](https://about.zenodo.org/policies/). In particular, the safelist is not in anyway a review of the quality of a research product. ----- -category: general -#### qaitem #### -question: How often do you review new users to be added to the safelist? ----- -answer: Submissions are reviewed at least once a day during business days. ----- -category: general -#### qaitem #### -question: How do I know if I am in the safelist? ----- -answer: - -Currently there is no visual inidicator on search results or record pages to tell if a user is safelisted or not. If you connected to Zenodo with your ORCiD or GitHub account, or had one of your uploads accepted in a community before the July 1st 2022, you were automatically added to the safelist. +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: -If you see your own or other users' uploads being listed at the very end of your search results, you can contact us via our [support form](https://zenodo.org/support) so that we can review the affected users and be manually added to the safelist. ----- -category: general diff --git a/content/help/faq/github/contents.lr b/content/help/faq/github/contents.lr index d6b7c39..1ee7025 100644 --- a/content/help/faq/github/contents.lr +++ b/content/help/faq/github/contents.lr @@ -4,48 +4,10 @@ title: GitHub --- sort_key: 8 --- -faqlist: - -#### qaitem #### -question: My organizational repository does not show up on the GitHub list. ----- -answer: - -In order to see and archive your organizational repositories on Zenodo you will need to have "Admin" permissions on said repository, either as an Admin of the organization or an Admin of one of your organization's repositories. -Additionally, please make sure that the OAuth application on GitHub grants permissions not only to your personal repositories but also to your organizational ones: To verify go to your GitHub OAuth settings in [your profile](https://github.com/settings/applications), and click on the Zenodo application to see more details. Also ensure that Zenodo is given access (green tick) to your organization under "Organization access". +toptext: -After that, navigate to your Zenodo [GitHub settings page](https://zenodo.org/account/settings/github/) and click the "Sync now" button at the top. ----- -category: github -#### qaitem #### -question: I made a GitHub release, but it does not show up on Zenodo. ----- -answer: Make sure the repository was enabled before the release was made, otherwise feel free to [contact us](https://zenodo.org/support). ----- -category: github -#### qaitem #### -question: Is it possible to archive a GitHub repository, before it was enabled on Zenodo? ----- -answer: Only the repositories which were enabled before a release was made will be archived automatically. If you want to archive some of your old releases, you can always download a release ZIP from GitHub and upload it to Zenodo using our web interface as a regular upload. ----- -category: github -#### qaitem #### -question: How to change the default metadata for my GitHub release? ----- -answer: You can include metadata in a `.zenodo.json` file at the root of your GitHub repository. This file's contents should be in line with the Zenodo deposit metadata schema and will be used to update the metadata from future GitHub releases. For more information on how to create a `.zenodo.json` file, you can have a look at our [GitHub integration documenation](https://developers.zenodo.org/#github). ----- -category: github -#### qaitem #### -question: Do you support other software metadata files, like `CITATION.cff` or `codemeta.json`? ----- -answer: Part of our plans and ongoing work is to take into account or improve our integration of other software metadata schemas such as the [Citation File Format (CFF)](https://citation-file-format.github.io/) and [CodeMeta](https://codemeta.github.io/). We are working closely with our users and scholarly software and citation communities to figure out exactly when, in what form, and how all these different metadata schemas and their files will be integrated into Zenodo. ----- -category: github -#### qaitem #### -question: How does a `CITATION.cff` file affect the metadata of my GitHub release? ----- -answer: When we find a `CITATION.cff` file in your GitHub repository's root folder, we make a best-effort attempt at parsing Zenodo-compatible metadata from it. - -For backwards-compatibility, if you have a `.zenodo.json` file in the repository, **only the `.zenodo.json`'s metadata will be taken into account**. Of course, any existing valid `CITATION.cff` file will still be used to display the citation box on the GitHub repository page, but will not affect in any way the metadata we extract for your published release Zenodo record. ----- -category: github +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/openaire/contents.lr b/content/help/faq/openaire/contents.lr index 56149b3..08a2724 100644 --- a/content/help/faq/openaire/contents.lr +++ b/content/help/faq/openaire/contents.lr @@ -4,91 +4,10 @@ title: OpenAIRE --- sort_key: 6 --- -faqlist: - -#### qaitem #### -question: What is OpenAIRE? ----- -answer: - -OpenAIRE is an acronym for “Open Access Infrastructure for Research in Europe”. OpenAIRE helps Horizon 2020 researchers report their publications to the EC Participant Portal and comply with the European Commission Open Access Policy and Research Data Pilot. - -OpenAIRE does this by aggregating European funded research output from nearly 1000 repositories from all over the world and makes them available via the OpenAIRE portal. - -OpenAIRE further provides a European-wide helpdesk for Open Access, research analytics services, payment of Article Processing Charges (APCs) for Gold Open Access FP7 publications. - -Zenodo is part of OpenAIRE and provides a repository for those researchers who do not have an existing institutional or thematic repository they can deposit their publications and data in. - -Read more about [OpenAIRE](https://www.openaire.eu/faqs). ----- -category: openaire-col1 -#### qaitem #### -question: When is my record available in OpenAIRE? ----- -answer: From June 2017, records are indexed immediately in OpenAIRE (i.e. you should be able to see the record within some few minutes in OpenAIRE). Note, that not all content in Zenodo is indexed by OpenAIRE (records display an OpenAIRE logo if they are indexed by OpenAIRE). ----- -category: openaire-col1 -#### qaitem #### -question: When is my record available in the EC Participant Portal? ----- -answer: Records are available immediately as soon as they are indexed in OpenAIRE (see above). ----- -category: openaire-col1 -#### qaitem #### -question: What content is indexed by OpenAIRE? ----- -answer: - -The following content is indexed in OpenAIRE: - -* Publications: - * All Open Access publications. - * Embargoed, restricted or closed access publications if they link to a grant. -* Datasets: - * All. Note that OpenAIRE only exposes datasets if the dataset is either a) linked to a publication in OpenAIRE or b) linked to a grant. - -For more information see the [OpenAIRE Content Acquisition Policy](https://www.openaire.eu/content-acquisition-policy). ----- -category: openaire-col1 -#### qaitem #### -question: Which funders do Zenodo support? ----- -answer: +toptext: -You can link records in Zenodo to grants from the following funders: - -* European Commission (Framework Programme 7/Horizon 2020). - -End-June 2017 we are also launching grants for the following funders: - -* ARC - Australian Research Council (Australia) -* FCT - Fundação para a Ciência e a Tecnologia, I.P. (Portugal) -* MESTD - Ministry of Education, Science and Technological Development (Serbia) -* MZOS - Ministry of Science, Education and Sports of the Republic of Croatia (Croatia) -* NHMRC - National Health and Medical Research Council (Australia) -* NSF - National Science Foundation (US) -* NWO - Netherlands Organisation for Scientific Research (Netherlands) -* WT - Wellcome Trust (UK) - -OpenAIRE furthermore has the following funders in the pipeline which will be -made available in Zenodo once they launched in OpenAIRE: - -* CSF - Croatian Science Foundation (Croatia) -* NIH - National Institutes of Health (US) -* RCUK - Research Council UK (UK) -* SFI - Science Foundation of Ireland (Ireland) -* SNSF - Swiss National Science Foundation (Switzerland) -* TARA - Tara Expeditions Foundation ----- -category: openaire-col2 -#### qaitem #### -question: Why is my grant is not available in Zenodo? ----- -answer: - -First check on above list if your funder is supported by Zenodo. If the funder is supported it can be that your grant is too new to appear in the database: - -* Zenodo relies on OpenAIRE’s grant database which we harvest once a week, so if the grant exists in the OpenAIRE database we will import it on the next update. -* OpenAIRE might not have your grant available in their database yet, because most often funders only provide their grant data on monthly or yearly basis, and often only in formats that require significant manual efforts to import. ----- -category: openaire-col2 +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/policies/contents.lr b/content/help/faq/policies/contents.lr index ba5ddc5..7ffc896 100644 --- a/content/help/faq/policies/contents.lr +++ b/content/help/faq/policies/contents.lr @@ -4,76 +4,10 @@ title: Policies --- sort_key: 3 --- -faqlist: - -#### qaitem #### -question: What are the size limits of Zenodo? ----- -answer: - -We currently accept up to 50GB per dataset (you can have multiple datasets). -However, we don't want to turn away use cases for larger datasets. -If you would like to upload larger files, please [contact us](https://zenodo.org/support), and we will do our best to help you. -Please be aware that we cannot offer infinite space for free, so donations towards sustainability are encouraged. - -There are no size limit on the number of records in communities. ----- -category: policies -#### qaitem #### -question: What can I upload? ----- -answer: - -All research outputs from all fields of science are welcome. -In the upload form you can choose between types of files: publications (book, book section, conference paper, journal article, patent, preprint, report, thesis, technical note, working paper, etc.), posters, presentations, datasets, images (figures, plots, drawings, diagrams, photos), software, videos/audio and interactive materials such as lessons. -Please see further information in our [Terms of Use](https://about.zenodo.org/terms) and [Policies](https://about.zenodo.org/policies). ----- -category: policies -#### qaitem #### -question: How does Zenodo handle sensitive datasets? ----- -answer: +toptext: -Where data that was originally [sensitive personal data](https://www.openaire.eu/sensitive-data-guide) is being uploaded for open dissemination through Zenodo, the uploader shall ensure that such data is either anonymised to an appropriate degree or fully consent cleared. -There are several tools that can help uploaders to anonymise their data such as OpenAIRE [Amnesia](https://amnesia.openaire.eu). ----- -category: policies -#### qaitem #### -question: Is Zenodo only for EU-funded research? ----- -answer: - -No. -We are open to all research outputs from all fields of science regardless of funding source. -Given that Zenodo was launched within an EU funded project, the knowledge bases were first filled with EU grants codes, but we are extending this to other funders. ----- -category: policies -#### qaitem #### -question: Is my data safe with you? What will happen to my uploads in the unlikely event that Zenodo has to close? ----- -answer: - -Yes, your data is safe as it is stored in the CERN Data Center. -Both data files and metadata are kept in multiple online and independent replicas. -CERN has considerable knowledge and experience in building and operating large scale digital repositories and a commitment to maintain this data centre to collect and store 100s of PBs of LHC data as it grows over the next 20 years. -In the highly unlikely event that Zenodo will have to close operations, we guarantee that we will migrate all content to other suitable repositories. Since all uploads have DOIs, all citations and links to Zenodo resources (such as your data) will not be affected. ----- -category: policies -#### qaitem #### -question: Is Zenodo OAIS compliant? ----- -answer: Zenodo and the underlying Invenio Framework for digital repositories were designed according to the OAIS reference model. Full OAIS compliance can only be proven through ISO 16363 certification which is a recent standard with very few repositories worldwide certified to date. See our [infrastructure page](https://about.zenodo.org/infrastructure/) for further details on Zenodo’s organizational and technical infrastructure. ----- -category: policies -#### qaitem #### -question: Does Zenodo have the CoreTrustSeal or other certification? ----- -answer: Not yet, since CoreTrustSeal at the moment only certifies repositories that serve a specifically designated community and therefore not generalist repositories like Zenodo. CoreTrustSeal is considering including generalist repositories in CoreTrustSeal 2022, at which point we would apply for certification. We have provided our input to CoreTrustSeal’s request for community feedback on this issue. ----- -category: policies -#### qaitem #### -question: Is Zenodo certified? ----- -answer: Zenodo is recommended by [FAIRsharing.org](https://fairsharing.org). We also have self-assessments for the FAIR principles and Plan S in our [Principles page](https://about.zenodo.org/principles/). ----- -category: policies +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/security/contents.lr b/content/help/faq/security/contents.lr index f2d5f33..a71874d 100644 --- a/content/help/faq/security/contents.lr +++ b/content/help/faq/security/contents.lr @@ -4,23 +4,10 @@ title: Security --- sort_key: 4 --- -faqlist: +toptext: -#### qaitem #### -question: Does Zenodo perform virus checks on uploaded files? ----- -answer: No, we do not perform virus checks on user-uploaded files. We however serve user-uploaded files in the most secure manner possible to protect users from various types of malicious attacks. ----- -category: security-col1 -#### qaitem #### -question: Is Zenodo GDPR-compliant? ----- -answer: Zenodo is hosted at CERN, which is an Intergovernmental Organization (IGO), with its seat in Switzerland and therefore not subject to the EU's General Data Protection Regulation (GDPR). Data protection at CERN, which Zenodo complies with, is governed by CERN’s Operational Circular 11 (OC11) that offers data protection at the same high standards and comparable to GDPR. You can read more about this in our relevant [blog post](https://blog.zenodo.org/2018/05/25/2018-05-25-gdpr/). ----- -category: security-col1 -#### qaitem #### -question: How do I share personal data? ----- -answer: Zenodo is an open dissemination research data repository, and the uploader of content responsible to ensure that the content is suitable for open dissemination and that it complies with applicable laws, including, but not limited to, privacy, data protection, and intellectual property rights. Thus, an uploader shall ensure that sensitive personal data is either anonymized to an appropriate degree or fully consent cleared. Uploaders considering Zenodo for the storage of non anonymized or encrypted/unencrypted sensitive personal data are therefore advised to use bespoke platforms rather than open dissemination services like Zenodo for sharing their data. ----- -category: security-col1 +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/statistics/contents.lr b/content/help/faq/statistics/contents.lr index 7462e19..b3867a0 100644 --- a/content/help/faq/statistics/contents.lr +++ b/content/help/faq/statistics/contents.lr @@ -4,148 +4,10 @@ title: Usage statistics --- sort_key: 7 --- -faqlist: - -#### qaitem #### -question: What do you track? ----- -answer: - -We track two types of events: - -1. Visits to a record page. -2. Downloads of a file. - -For both types of events, we track: - -1. **Visitor:** An anonymized visitor ID. -2. **Visitor type:** If the request was made by a) human, b) machine or c) robot. -3. **Country:** The country of origin of the request (based on the IP address). -4. **Referrer:** The referrer domain. ----- -category: statistics-col1 -#### qaitem #### -question: What is a *view*? ----- -answer: A user (human or machine) visiting a record, excluding double-clicks and robots. ----- -category: statistics-col1 -#### qaitem #### -question: What is a *unique view*? ----- -answer: A *unique view* is defined as one or more visits by a user within a 1-hour time-window. This means that if the same record was accessed multiple times by the same user within the same time-window, we consider it as one unique view. ----- -category: statistics-col1 -#### qaitem #### -question: What is a *download*? ----- -answer: A user (human or machine) downloading a file from a record, excluding double-clicks and robots. If a record has multiple files and you download all files, each file counts as one download. ----- -category: statistics-col1 -#### qaitem #### -question: What is a *unique download*? ----- -answer: A *unique download* is defined as one or more file downloads from files of a single record by a user within a 1-hour time-window. This means that if one or more files of the same record were downloaded multiple times by the same user within the same time-window, we consider it as one unique download. ----- -category: statistics-col1 -#### qaitem #### -question: What is *downloaded data volume*? ----- -answer: The total data volume that has been downloaded for all files in a record by a user (human or machine), excluding double-clicks and robots. In case a user cancels a file download mid-way, we still count the total file size as fully downloaded. ----- -category: statistics-col1 -#### qaitem #### -question: How do you deal with versions? ----- -answer: By default, for a record, we display the aggregated counts of views, downloads and data volume for all versions of a record. You can further expand the usage statistics box on a record page to see the counts for the specific version. ----- -category: statistics-col1 -#### qaitem #### -question: How do you deal with robots? ----- -answer: Requests made by robots (aka crawlers, spiders, bots) are filtered out from the usage statistics. We detect robots based on a standardized list of robots provided by the [COUNTER](https://www.projectcounter.org/) and [Making Data Count](https://makedatacount.org/) projects. ----- -category: statistics-col1 -#### qaitem #### -question: How often do you update usage statistics? ----- -answer: Once a day. ----- -category: statistics-col1 -#### qaitem #### -question: How can I see the most viewed records? ----- -answer: Any search on Zenodo allows you to sort the search results by "[most viewed](https://zenodo.org/search?sort=mostviewed)". ----- -category: statistics-col1 -#### qaitem #### -question: How do you track? ----- -answer: We comply with the [COUNTER Code of Practice](https://www.projectcounter.org/) as well as the [Code of Practice for Research Data Usage Metrics](https://peerj.com/preprints/26505/) in our tracking. This means that our usage statistics can be compared with other COUNTER-compliant repositories. ----- -category: statistics-col1 -#### qaitem #### -question: What is the difference between a machine and a robot? ----- -answer: A *machine request* is an automated request initiated by a human user, e.g. a script downloading data from Zenodo and running an analysis on the data. A *robot request* is an automated request made by e.g. a search engine crawler. ----- -category: statistics-col2 -#### qaitem #### -question: How do you anonymize users? ----- -answer: +toptext: -For each view/download event, we track an anonymized visitor ID. This anonymized visitor ID changes for a user every 24 hours, hence a user viewing the same record on two different days will have two different anonymized visitor IDs. The reason we track an anonymized visitor ID is in order to count unique views and downloads. - -For security purposes, we also keep a web server access log which includes your [IP address](https://en.wikipedia.org/wiki/IP_address) and your browser’s [user agent](https://en.wikipedia.org/wiki/User_agent) string. This web server access log is automatically deleted after 1 year max. and is also strictly separated from the usage statistics collection. - -The anonymized visitor ID is generated from a personal identifier such as: - 1. a user ID (e.g. if you are logged in on zenodo.org), - 2. a session ID, - 3. or an IP address and your browser’s user-agent string. - -We combine the personal identifier with a random text value (a salt) and apply a one-way [cryptographic hash function](https://en.wikipedia.org/wiki/Cryptographic_hash_function) to scramble the data. The salt (random text value) is thrown away and regenerated every 24 hours. Using and discarding the random salt afterwards ensures that the anonymized visitor ID is fully random. ----- -category: statistics-col2 -#### qaitem #### -question: Can I opt-out of the usage statistics tracking? ----- -answer: No, it is not possible to opt-out. The usage statistics tracking is fully anonymized and is done on the server-side. ----- -category: statistics-col2 -#### qaitem #### -question: Who do you share usage statistics with? ----- -answer: We share *aggregated* usage statistics with [OpenAIRE Usage Counts](https://usagecounts.openaire.eu/) as well as the [DataCite Sashimi](https://github.com/datacite/sashimi) service. Note, that only aggregated usage statistics are shared, which do not include any anonymized visitor IDs. ----- -category: statistics-col2 -#### qaitem #### -question: What do you share with third parties? ----- -answer: We share only *aggregated* usage statistics with third-parties. We never share the raw usage statistics events, even though these usage statistics events are fully anonymized. ----- -category: statistics-col2 -#### qaitem #### -question: How did you get usage statistics from 2013 until 2018? ----- -answer: From 2013, we have been using a self-hosted Piwik instance to track usage statistics for zenodo.org. We were able to extract record views and downloads from this Piwik instance. [Studies](https://doi.org/10.5281/zenodo.1034164) have however shown that Piwik fails at counting as much as 50-60% of the actual visits to a site. ----- -category: statistics-col2 -#### qaitem #### -question: Do you support usage statistics for a community? ----- -answer: Not yet, but we will be adding aggregated usage statistics for your communities. ----- -category: statistics-col2 -#### qaitem #### -question: Do you track my search queries? ----- -answer: No. ----- -category: statistics-col2 -#### qaitem #### -question: Do you do any manual or automatic profiling of users? ----- -answer: No. ----- -category: statistics-col2 +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/technical/contents.lr b/content/help/faq/technical/contents.lr index 9c532c8..4c3a81f 100644 --- a/content/help/faq/technical/contents.lr +++ b/content/help/faq/technical/contents.lr @@ -4,28 +4,10 @@ title: Technical --- sort_key: 2 --- -faqlist: - -#### qaitem #### -question: How can I edit the metadata of a published record? ----- -answer: On the record page and click the orange *Edit* button in the top-right corner. You will be taken to a form similar to the upload form, where you will be able to edit almost all of the record's metadata. Once you are done modifying it, click "Save" and then "Publish". ----- -category: technical -#### qaitem #### -question: Why am I getting an error when trying to upload files? ----- -answer: - -The error may occur due to some network issues or instability. You can try to upload from another network/machine (wired connections are also more stable). - -If you are familiar with the command line and/or scripting, we have some snippets available that are a bit more resilient compared to browser-based uploads: -* [using curl](https://gist.github.com/slint/2263b2212743a68b2851b2cb7865675e) -* [using Python](https://gist.github.com/slint/92e4d38eb49dd177f46b02e1fe9761e1) +toptext: -Finally, another option is to split the file(s) into smaller parts (if possible) which might also ease the process of distributing the dataset after publishing. - -We also provide a [testing instance of Zenodo](https://sandbox.zenodo.org/), where you can freely try things out. - ----- -category: technical +
+

Moved to https://support.zenodo.org/help/

+
+--- +faqlist: diff --git a/content/help/faq/versioning/contents.lr b/content/help/faq/versioning/contents.lr index a544573..cf716b8 100644 --- a/content/help/faq/versioning/contents.lr +++ b/content/help/faq/versioning/contents.lr @@ -4,111 +4,10 @@ title: Versioning --- sort_key: 5 --- -faqlist: - -#### qaitem #### -question: What is DOI versioning? ----- -answer: - -DOI versioning allows you to: - -* edit/update the record’s files after they have been published. -* cite a specific version of a record. -* cite all of versions of a record. ----- -category: versioning-col1 -#### qaitem #### -question: How does DOI versioning work? ----- -answer: - -When you publish an upload on Zenodo for the first time, we register two DOIs: - -* a DOI representing the **specific version** of your record. -* a DOI representing **all of the versions** of your record. - -Afterwards, we register a DOI for every new version of your upload. - -This is best illustrated by an example of a software package. If the software has been released in two versions (v1.0 and v1.1) on Zenodo, then the following DOIs would have been registered: - -* **v1.0 (specific version):** 10.5281/zenodo.60943 -* **v1.1 (specific version):** 10.5281/zenodo.800648 -* **Concept (all versions):** 10.5281/zenodo.705645 - -The first two DOIs for versions **v1.0** and **v.1.1** represent the specific versions of the software. The last DOI represents all the versions of the given software package, i.e. the concept of the software package and the ensemble of versions. We therefore also call the them **Version DOIs** and **Concept DOIs** (note, technically both are just normal DOIs). - -You may notice that the version DOIs do not include a “.v1”-suffix. [Read below](/faq/#cversioning-8) to find out why. ----- -category: versioning-col1 -#### qaitem #### -question: Which DOI should I use in citations? ----- -answer: +toptext: -You should normally always use the DOI for the **specific version** of your record in citations. This is to ensure that other researchers can access the **exact** research artefact you used for reproducibility. By default, Zenodo uses the specific version to generate citations. - -You can use the Concept DOI representing all versions in citations when it is desirable to cite an evolving research artifact, without being specific about the version. ----- -category: versioning-col1 -#### qaitem #### -question: Where does the Concept DOI resolve to? ----- -answer: Currently the Concept DOI resolves to the landing page of the latest version of your record. This is not fully correct, and in the future we will change this to create a landing page specifically representing the concept behind the record and all of its versions. ----- -category: versioning-col1 -#### qaitem #### -question: Do you support versioning for already existing records? ----- -answer: - -Yes. However, for uploads published before the 30th of May 2017, you have to first upgrade your record to support versioning. This is done by clicking the “Upgrade to versioned record” button on the record page. - -IMPORTANT -If you have previously uploaded multiple versions of an upload as individual records on Zenodo, then DO NOT click the button to upgrade your record with versioning support. Please [contact us](https://zenodo.org/support) so we can link the records under one versioning scheme. Clicking the “Upgrade to versioned record” button on any of the records you would like to link, will irreversibly register them as individually-versioned records. - -If you used the GitHub integration to archive your software on Zenodo, then we have already migrated and linked your records to support versioning. ----- -category: versioning-col1 -#### qaitem #### -question: Do you support DOI versioning for DOIs from providers other than Zenodo? ----- -answer: No, we only support DOI versioning for records with Zenodo DOIs (i.e. DOIs starting with the prefix 10.5281). ----- -category: versioning -#### qaitem #### -question: I only want to change the title of my upload, do I still get a new DOI? ----- -answer: No, you can continue to edit the metadata of your upload without creating a new version of a record. You should only create a new version if you want to update the files of your record. ----- -category: versioning-col2 -#### qaitem #### -question: Why don’t the DOIs have a version number suffix like “.v1”? ----- -answer: - -Including semantic information such as the version number in a DOI is bad practice, because this information may change over time, while DOIs must remain persistent and should not change. - -Moreover, Zenodo DOI versioning is linear, which means that the Zenodo version number may in fact not be the real version number of the resource. Take for instance software, where it is common practice to have dot versions and make new releases in a non-linear order (e.g. first v1.0, then v1.1, then v2.0, then v1.2). - -The versioning suffix is also not a functionality of the DOI system, i.e. adding .v2 to DOI will not resolve to version 2 of a resource for any DOI from any provider. Different providers also use different patterns such as e.g. .v2, .2, /2. - -Most importantly, version suffixes are not machine readable. A discovery system that understands DOIs, will not know that .v1 and .v2 of a DOI are in fact two versions of the same resource. - -A better solution to this problem is to semantically link two DOIs in the metadata of a DOI. This ensures that discovery systems have a machine-readable way to discover that two DOIs are versions of the same resource. - -See also [Cool DOIs](https://doi.org/10.5438/55E5-T5C0) blog post by Martin Fenner, DataCite Technical Director. ----- -category: versioning-col2 -#### qaitem #### -question: Why do you include “zenodo” in the DOI? ----- -answer: Currently DOIs registered by Zenodo follows the pattern “10.5281/zenodo.<integer>” where 10.5281 is the Zenodo DOI prefix and <integer> is a sequentially assigned integer. The word “zenodo” is semantic information and, as mentioned in the previous answer, it is a bad idea to include semantic information in DOIs as it may change over time. The current practice was introduced when Zenodo was launched in May 2013, and while it is not ideal we did not want to change the existing practice. ----- -category: versioning-col2 -#### qaitem #### -question: Do you duplicate all the files for every new version of a record? ----- -answer: No, if you change a 10kb README file in 50GB dataset we do not duplicate the entire 50GB dataset. [Invenio v3](https://inveniosoftware.org/products/framework/), the underlying digital repository platform that powers Zenodo, efficiently handles the file storage so we only store the new 10kb. +
+

Moved to https://support.zenodo.org/help/

+
--- -category: versioning-col2 +faqlist: diff --git a/templates/blocks/sectionindex.html b/templates/blocks/sectionindex.html index 60507a9..78c830a 100644 --- a/templates/blocks/sectionindex.html +++ b/templates/blocks/sectionindex.html @@ -1,3 +1,4 @@ +{%- if this.menu %} {%- set rootsite = this.menu.split("/")[1]%} {%- set rootprefix = bag('prefix', rootsite) %} {% if rootprefix != "/" + rootsite %} @@ -37,3 +38,11 @@

{{section.title}}

{%- endif %} +{%- else %} +
+

{{this.title}}

+
+ +{{this.body}} +
+{%- endif %} diff --git a/templates/faq.html b/templates/faq.html index c7259cf..2298f81 100644 --- a/templates/faq.html +++ b/templates/faq.html @@ -23,6 +23,7 @@ {% block title %}{{ this.title }}{% endblock %} {% block body %} {{ this.toptext }} +{# {% set children = this.children|sort(attribute="sort_key") or [this] %} {%- for child in children %}

{{ child.title}}

@@ -47,6 +48,7 @@

{{child.bottomtext}} {%- endfor %} +#}

{{ this.bottomtext }}