Skip to content

Update README to v4 - #2889

Merged
erikvansebille merged 6 commits into
Parcels-code:mainfrom
erikvansebille:update-readme
Sep 10, 2026
Merged

Update README to v4#2889
erikvansebille merged 6 commits into
Parcels-code:mainfrom
erikvansebille:update-readme

Conversation

@erikvansebille

Copy link
Copy Markdown
Member

Description

This PR updates the links in README.md to v4. it also aligns some of the text with that on https://docs.parcels-code.org/en/stable/index.html

Checklist

  • This PR targets the correct branch (main for normal development, v3-support for v3 support)

AI Disclosure

None

Comment thread README.md
Comment on lines -17 to -19
> [!WARNING]
> This branch contains version 4 of Parcels which is in active development. See `v3-support` to see v3 or the tags to browse stable versions of Parcels.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we still maintaining the v3-support branch?

I think it would be a good idea at least until we get more user feedback.

@erikvansebille erikvansebille Sep 10, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I think we do keep the v4-support branch. But perhaps not as a warning - I'll change it to an INFO message

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in d363ced

Comment thread README.md Outdated
### Further information

See [parcels-code.org](http://parcels-code.org/) for further information about [installing](https://docs.parcels-code.org/en/latest/installation.html) and [running](https://docs.parcels-code.org/en/latest/documentation.html) the Parcels code, as well as extended [documentation](https://docs.parcels-code.org/en/latest/reference.html) of the methods and classes.
See [parcels-code.org](http://parcels-code.org/) for further information about [installing](https://docs.parcels-code.org/en/stable/user_guide/getting_started/installation.html) and [running](https://docs.parcels-code.org/en/stable/user_guide/index.html) the Parcels code, as well as extended [API reference](https://docs.parcels-code.org/en/stable/reference/parcels/index.html) of the methods and classes.

@VeckoTheGecko VeckoTheGecko Sep 10, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have now finished reconfiguring RTD - so we have the latest tag again.

  • latest - builds off main
  • stable - builds off the latest release

I think we should point everything in README's and in code to the latest tag, which is now also the default version in the docs

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, but if the (default) documentation builds off main, while most users will install the latest release - don't we run the risk that the documentation doesn't (entirely) align with the code users have.

Or is that the reason why we "freeze" the API, so that from a user perspective nothing changes until the next release?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in cdc5861

@VeckoTheGecko VeckoTheGecko left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

small edit - otherwise looks good

Comment thread README.md Outdated
erikvansebille and others added 2 commits September 10, 2026 10:48
Co-authored-by: Nick Hodgskin <36369090+VeckoTheGecko@users.noreply.github.com>
@erikvansebille
erikvansebille enabled auto-merge (squash) September 10, 2026 08:49
@erikvansebille
erikvansebille merged commit e8654e3 into Parcels-code:main Sep 10, 2026
21 checks passed
@github-project-automation github-project-automation Bot moved this from Backlog to Done in Parcels development Sep 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants