[Bug 283499] www/garage: minor improvements to pkg-message

From: <bugzilla-noreply_at_freebsd.org>
Date: Sun, 22 Dec 2024 22:46:08 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=283499

            Bug ID: 283499
           Summary: www/garage: minor improvements to pkg-message
           Product: Ports & Packages
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Individual Port(s)
          Assignee: ashish@FreeBSD.org
          Reporter: saper@saper.info
             Flags: maintainer-feedback?(ashish@FreeBSD.org)
          Assignee: ashish@FreeBSD.org

Hello, thanks for porting this to FreeBSD.

Two small nits:

%%DOCSDIR%%/book/src/quick_start/index.md

should probably become

%%DOCSDIR%%/book/quick-start/_index.md

Also the upgrade instructions tell how to upgrade from 0.8 to 0.9, there should
probably be an extra message for 1.0:

https://garagehq.deuxfleurs.fr/documentation/working-documents/migration-1/

This guide explains how to migrate to 1.0 if you have an existing 0.9 cluster.
We don't recommend trying to migrate to 1.0 directly from 0.8 or older.

This migration procedure has been tested on several clusters without issues.
However, it is still a critical procedure that might cause issues. Make sure to
back up all your data before attempting it!

You might also want to read our general documentation on upgrading Garage.
Changes introduced in v1.0

The following are breaking changes in Garage v1.0 that require your attention
when migrating:

    The Sled metadata db engine has been removed. If your cluster was still
using Sled, you will need to use a Garage v0.9.x binary to convert the database
using the garage convert-db subcommand. See here for the details of the
procedure.

-- 
You are receiving this mail because:
You are the assignee for the bug.