Update documentation to describe annotation file format version updates

[allemangD]

When creating a conversion script, you also need to add the version to the version_order list in converters.py

Otherwise, LGTM. Thanks for putting this together!

[jcfr]

Due to the fact that ...

• readthedocs was not up-to-date (see details below)
• the section Modifying the File Format was in the Annotation.md file and not in the AnnotationFileFormat.md one

I duplicated information and we will have to re-consolidate.

readthedocs: Build error

It was fixed by disabling the epub build in the readthedocs admin interface.

For reference, the following warning was reported:

  WARNING: conf value "version" should not be empty for EPUB3

as well as the following error

    [...]
    File "/home/docs/checkouts/readthedocs.org/user_builds/cell-locator/envs/latest/lib/python3.7/site-packages/sphinx/builders/_epub_base.py", line 702, in build_epub
      epub.write(path.join(self.outdir, filename), filename, ZIP_DEFLATED)
    File "/home/docs/.pyenv/versions/3.7.9/lib/python3.7/zipfile.py", line 1730, in write
      zinfo = ZipInfo.from_file(filename, arcname)
    File "/home/docs/.pyenv/versions/3.7.9/lib/python3.7/zipfile.py", line 530, in from_file
      zinfo = cls(arcname, date_time)
    File "/home/docs/.pyenv/versions/3.7.9/lib/python3.7/zipfile.py", line 357, in __init__
      raise ValueError('ZIP does not support timestamps before 1980')
  ValueError: ZIP does not support timestamps before 1980

Source: https://readthedocs.org/projects/cell-locator/builds/17535063/

readthedocs: Sync issue

We will have to ask the organization administrator to re-sync the hook. This will allow to:

• ensure the latest documentation is always re-built
• enable the preview build of pull request