Skip to content

Conversation

@albertony
Copy link
Contributor

What is the purpose of this change?

In light of recent, and ongoing, cleanup and linting of Markdown documentation, I have extended the contributing guide a bit. Most important is an explanation of the make backenddocs, which can be run to verify the resulting Markdown locally, but make it clear that it updates markdown files which should not be committed afterwards.

Was the change discussed in an issue or in the forum before?

Checklist

  • I have read the contribution guidelines.
  • I have added tests for all changes in this PR if appropriate.
  • I have added documentation for the changes if appropriate.
  • All commit messages are in house style.
  • I'm done, this Pull Request is ready for review :-)

@albertony albertony self-assigned this Nov 5, 2025
CONTRIBUTING.md Outdated
Comment on lines 448 to 450
After your changes has been merged, you can verify them on
[tip.rclone.org](https://tip.rclone.org). They will be included on the main
[rclone.org](https://rclone.org) site once they have been included in a release.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Can we be more specific regarding when the tip.rclone.org will be updated with changes after a PR has been merged?

Copy link
Member

Choose a reason for hiding this comment

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

I looked at the crontab - tip.rclone.org is updated at 06:00 UTC daily. However the webserver is refreshed only hourly so it is likely not visible until 07:00 UTC.

How about

tip.rclone.org is updated daily with the current state of the master branch at 07:00 UTC

Copy link
Member

@ncw ncw left a comment

Choose a reason for hiding this comment

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

Looks good :-)

CONTRIBUTING.md Outdated
Comment on lines 448 to 450
After your changes has been merged, you can verify them on
[tip.rclone.org](https://tip.rclone.org). They will be included on the main
[rclone.org](https://rclone.org) site once they have been included in a release.
Copy link
Member

Choose a reason for hiding this comment

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

I looked at the crontab - tip.rclone.org is updated at 06:00 UTC daily. However the webserver is refreshed only hourly so it is likely not visible until 07:00 UTC.

How about

tip.rclone.org is updated daily with the current state of the master branch at 07:00 UTC

@albertony
Copy link
Contributor Author

Perfect. Thanks for checking the tip.rclone.org details!

@albertony albertony merged commit ec5ddb6 into rclone:master Nov 5, 2025
0 of 9 checks passed
@albertony albertony deleted the contributing-docs branch November 5, 2025 13:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants