From 4d6b726677d79c5aa23ffb8c0e03b37f8a2f772e Mon Sep 17 00:00:00 2001 From: Ghislain Durif Date: Tue, 21 Feb 2023 15:16:03 +0100 Subject: [PATCH] minor modifications and improvements --- _pages/submit.md | 39 ++++++++++++++++++--------------------- 1 file changed, 18 insertions(+), 21 deletions(-) diff --git a/_pages/submit.md b/_pages/submit.md index 64874958..8648703b 100644 --- a/_pages/submit.md +++ b/_pages/submit.md @@ -11,25 +11,24 @@ nav: true ## Overview - Submissions to Computo require both scientific content (typically equations, codes and figures, data) and a proof that this content is reproducible. This is achieved by means of i) a notebook system, ii) a virtual environment fixing the dependencies and iii) continuous -integration (plus, if needed, an external website to store large data -files such a Zenodo or OSF ). +integration (plus, if needed, an external website to store data +files such as [Zenodo](https://zenodo.org/) or [OSF](https://osf.io/) ). -A Computo submission is thus a git(hub) repository typically containing +A Computo submission is thus a git repository (e.g. Github or Gitlab) typically containing - the source file of the notebook (a markdown file with yaml metadata) - auxiliary files: a $$\mathrm{bib}\TeX $$ file and some statics files, e.g. figures or small .csv data tables - configuration files to set up the dependencies in a virtual environment - configuration files to set up the continuous integration rendering the final documents -The compiled notebook (both HTML and PDF) will be generated directly +The compiled notebook (both HTML and PDF) will be directly generated in the git(hub) repository via continuous integration (e.g., Github -action or Gitlab CI) and published, if the action is successful, to -web page (e.g. gh-page). +action or Gitlab CI) and published, if the action is successful, +to a web page (e.g. gh-page). The PDF and the git repository address are then submitted to the
Warning!
-

To start writing your own contribution, do not start from scratch!! You must clone the github repository associated with one of the following templates. Then, rename it an share it on your own github account.

+

To start writing your own contribution, do not start from scratch!! You must click on "use this template" button (top right) on the github repository associated with one of the following templates. Then, rename it an share it on your own github account.

@@ -51,9 +50,9 @@ dedicated post]({{ site.baseurl }}/blog/2021/submission-process/). ### Quarto-based templates -Choosing one of [our quarto-based extension](https://github.com/computorg/computo-quarto-extension) would help us in the final formatting process of your article. Moreover, it supports both R, Python and Julia! +Choosing one of **our templates** (c.f. below) or [our quarto-based extension](https://github.com/computorg/computo-quarto-extension) would help us in the final formatting process of your article. Moreover, it supports R, Python and Julia! -We have templates for setting everything up either for R, Python and Julia users: +In particular, we have dedicated templates for setting everything up either for R, Python and Julia users:
@@ -71,15 +70,15 @@ if you are attached to Jupyter book or do not prefer to use Quarto, you are of c
-## Large Files +## Data and large files -If your submission materials contain files larger than 100MB, they won’t fit on a git repository as is. For this reason, we encourage you to put your data or any materials you deem necessary on a “open data” centered repository hub like [Zenodo](https://zenodo.org/). +If your submission materials contain files larger than 50MB, **especially data files**, they won’t fit on a git repository as is. For this reason, we encourage you to put your data or any materials you deem necessary on an external “open data” centered repository hub such a [Zenodo](https://zenodo.org/) or [OSF](https://osf.io/). ## Submit your work -Once your are happy with your notebook AND the github-action is -successful, you may submit your PDF via Scholastica, our platform for -peer-reviewing: +Once your are happy with your notebook AND the continuous integration +(Github action or Gitlab CI) is successful, you may submit your PDF via +Scholastica, our platform for peer-reviewing:
Submit to Computo
@@ -87,9 +86,9 @@ peer-reviewing: ## Reviewing and publication Submitted papers are reviewed by external reviewers selected by the Associate Editor in charge of the paper. -Computo strives for fast reviewing cycles, but cannot provide strict guarantees on the matter; the current time between submission and final submission is under six months. +Computo strives for fast reviewing cycles, but cannot provide strict guarantees on the matter; the current time between submission and final publication is under six months. -Computo's accepted papers are published electronically immediately upon receipt under CC BY 4.0 license. +Computo's accepted papers are published electronically immediately upon receipt under [CC BY 4.0 license](https://creativecommons.org/licenses/by/4.0/). Authors retain the copyright and full publishing rights without restrictions. More details about the reviewing process are available on the [Review page]({{ site.baseurl }} /review) @@ -103,15 +102,13 @@ More details about the reviewing process are available on the [Review page]({{ s Authors shall disclose any potential conflict of interest, whether it is professional, financial or other, to the journal’s Editor, if this conflict could be interpreted as having influenced their work. Authors shall declare all sources of funding for the research presented in the article. -- **Impartiality**: +- **Impartiality**: All articles are examined impartially, and their merits are assessed regardless of the sex, religion, sexual orientation, nationality, ethnic origin, length of service or institutional affiliation of the author(s). - **Funding**: All funding received by the author(s) shall be clearly stated in the article(s). - **Defamatory statements**: Authors guarantee that their proposed article contains no matter of a defamatory, hateful, fraudulent or knowingly inexact character. -- **References**: +- **References**: Authors guarantee that all the publications used in their work have been cited appropriately. - -