From a50350abd61a60e87f7f985593a07b9a861e9438 Mon Sep 17 00:00:00 2001 From: Johannes Soltwedel <38459088+jo-mueller@users.noreply.github.com> Date: Thu, 8 Jan 2026 10:46:44 +0100 Subject: [PATCH 1/3] merge contribution guide contents --- CONTRIBUTING.md | 26 -------------------------- README.md | 2 +- contributing/index.md | 32 +++++++++++++++++++++++++++++++- 3 files changed, 32 insertions(+), 28 deletions(-) delete mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 86dbd094..00000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,26 +0,0 @@ -# Contributing to OME - -Detailed guidance for contributing developers is available at -https://docs.openmicroscopy.org/contributing/ - -## The Quick Version - -* Fork the repository on GitHub -* Create a branch for your work based on the latest `dev_x` e.g. dev_5_0 - branch or `develop` -* Make your commits and open a PR - -# Contributing to this repository - -## Syntax -This repository uses Sphinx to publish a ReadTheDocs site at https://ngff.openmicroscopy.org in the [Sphinx Book Theme](https://sphinx-book-theme.readthedocs.io/en/stable/). - -[MyST](https://myst-parser.readthedocs.io/en/latest/) syntax can be used in addition to basic Markdown and HTML. - -## Configuration -Edit [conf.py](./conf.py) with options from the [Sphinx Book Theme](https://sphinx-book-theme.readthedocs.io/en/stable/). The [PyData Sphinx Theme](https://pydata-sphinx-theme.readthedocs.io/en/stable/user_guide) user guide may also have more up to date instructions for configuration properties. - -## Previews -Each PR receives a unique preview URL of the format `https://ngff--.org.readthedocs.build/` where `` is the PR number. This link is also posted to each PR by the Github actions bot in an "Automated Review URLs" comment as the "Readthedocs" link. - -Please check that your changes render correctly at this URL. New commits will automatically be live at the PR url after a few minutes. \ No newline at end of file diff --git a/README.md b/README.md index d0d38d56..4821dff2 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ We welcome contributions from anyone! Create Issues and PRs on this repo for con Content can be created using Markdown, HTML, and [MyST](https://myst-parser.readthedocs.io/en/latest/) syntax. -See also [CONTRIBUTING.md](./CONTRIBUTING.md) +See also [CONTRIBUTING.md](./contributing/index.md) # Specifications diff --git a/contributing/index.md b/contributing/index.md index 0ca43720..0c88f6a3 100644 --- a/contributing/index.md +++ b/contributing/index.md @@ -24,4 +24,34 @@ relevant RFC. A template is also available for formatting your comment: ## Changes to this website -The repository for this website is [ome/ngff](https://github.com/ome/ngff). Contributions to these pages are welcome as issues or PRs. Please read the [contributing guide](https://github.com/ome/ngff/blob/main/CONTRIBUTING.md). +The repository for this website is [ome/ngff](https://github.com/ome/ngff). Contributions to these pages are welcome as issues or PRs. + +### Syntax +This repository uses Sphinx to publish a ReadTheDocs site at https://ngff.openmicroscopy.org in the [Sphinx Book Theme](https://sphinx-book-theme.readthedocs.io/en/stable/). + +[MyST](https://myst-parser.readthedocs.io/en/latest/) syntax can be used in addition to basic Markdown and HTML. + +### Configuration +Edit [conf.py](./conf.py) with options from the [Sphinx Book Theme](https://sphinx-book-theme.readthedocs.io/en/stable/). The [PyData Sphinx Theme](https://pydata-sphinx-theme.readthedocs.io/en/stable/user_guide) user guide may also have more up to date instructions for configuration properties. + +### Previews +Each PR receives a unique preview URL of the format `https://ngff--.org.readthedocs.build/` where `` is the PR number. This link is also posted to each PR by the Github actions bot in an "Automated Review URLs" comment as the "Readthedocs" link. + +Please check that your changes render correctly at this URL. New commits will automatically be live at the PR url after a few minutes. + +## Contributing to OME +(contributing:ome)= + +Detailed guidance for contributing developers is available at +https://docs.openmicroscopy.org/contributing/ + +### The Quick Version + +* Fork the repository on GitHub +* Create a branch for your work based on the latest `dev_x` e.g. dev_5_0 + branch or `develop` +* Make your commits and open a PR + + + + From a923a25e26c7e90090b7463b0e4a1310450b3730 Mon Sep 17 00:00:00 2001 From: Johannes Soltwedel <38459088+jo-mueller@users.noreply.github.com> Date: Thu, 8 Jan 2026 13:19:45 +0100 Subject: [PATCH 2/3] added link formatting --- contributing/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contributing/index.md b/contributing/index.md index 0c88f6a3..c74eba2c 100644 --- a/contributing/index.md +++ b/contributing/index.md @@ -43,7 +43,7 @@ Please check that your changes render correctly at this URL. New commits will au (contributing:ome)= Detailed guidance for contributing developers is available at -https://docs.openmicroscopy.org/contributing/ +[https://docs.openmicroscopy.org/contributing/](https://docs.openmicroscopy.org/contributing/) ### The Quick Version From c9c9d1bc73d4638db48163b9178e02356cc424ea Mon Sep 17 00:00:00 2001 From: Johannes Soltwedel <38459088+jo-mueller@users.noreply.github.com> Date: Thu, 8 Jan 2026 13:27:20 +0100 Subject: [PATCH 3/3] Pointed to ngff-psec in contribution guidelines --- contributing/index.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/contributing/index.md b/contributing/index.md index c74eba2c..1f36dea6 100644 --- a/contributing/index.md +++ b/contributing/index.md @@ -22,9 +22,20 @@ please leave a comment in a new page under the "comments/" directory for the relevant RFC. A template is also available for formatting your comment: [template](../rfc/1/templates/review_template). +### How to change the specification + +To make a change such as the end-product of an RFC or a minor correction to the currently developed specification version, +please do so via a pull request (PR) against the `main` branch of the [ome/ngff-spec](https://github.com/ome/ngff-spec) repository. +This repository contains the specification documents in Markdown format, +json examples and the schema files for validation. + ## Changes to this website -The repository for this website is [ome/ngff](https://github.com/ome/ngff). Contributions to these pages are welcome as issues or PRs. +The repository for this website is [ome/ngff](https://github.com/ome/ngff). +Contributions to these pages are welcome as issues or PRs. + +To do so, create a fork of the ``ome/ngff`` repository, make your changes, +and submit a pull request (PR) against the `main` branch. ### Syntax This repository uses Sphinx to publish a ReadTheDocs site at https://ngff.openmicroscopy.org in the [Sphinx Book Theme](https://sphinx-book-theme.readthedocs.io/en/stable/). @@ -44,14 +55,3 @@ Please check that your changes render correctly at this URL. New commits will au Detailed guidance for contributing developers is available at [https://docs.openmicroscopy.org/contributing/](https://docs.openmicroscopy.org/contributing/) - -### The Quick Version - -* Fork the repository on GitHub -* Create a branch for your work based on the latest `dev_x` e.g. dev_5_0 - branch or `develop` -* Make your commits and open a PR - - - -