docs file fixes, link updates (#4362)

* docs file fixes, link updates * compareGeneratedSqlWithExpectedSqlForMinimalChangesets sql test files removed. --------- Co-authored-by: Daniel Mallorga <dmallorga@liquibase.com>
liquibase · Jul 26, 2023 · b787b9a · b787b9a
1 parent f183ba9
commit b787b9a
Show file tree

Hide file tree

Showing 11 changed files with 14 additions and 14 deletions.
diff --git a/README.md b/README.md
@@ -31,7 +31,7 @@ Liquibase system requirements can be found on the [Download Liquibase](https://w
 6. Run the `liquibase update` command.
 7. Run the `liquibase history` command to see what has executed!
 
-See also how to [get started with Liquibase in minutes](https://www.liquibase.org/get-started/quickstart) or refer to our [Installing Liquibase](https://docs.liquibase.com/install/home.html) documentation page for more details.
+See also how to [get started with Liquibase in minutes](https://www.liquibase.org/get-started/quickstart) or refer to our [Installing Liquibase](https://docs.liquibase.com/start/install/home.html) documentation page for more details.
 
 ## Documentation
 

diff --git a/liquibase-dist/src/main/archive/GETTING_STARTED.txt b/liquibase-dist/src/main/archive/GETTING_STARTED.txt
@@ -139,7 +139,7 @@ as defined by the changelog script.
 The DATABASECHANGELOG and DATABASECHANGELOGLOCK tables are liquibase-metadata tables. 
 Also, the changelog created the COMPANY and PERSON tables.
 
-Now, open the sample.changelog.xml or samplechangelog.h2.sql file in your favorite 
+Now, open the `example-changelog.xml` or `example-changelog.sql` file in your favorite 
 text editor.
 
 In each file, you can see how changes were defined as a series of changeSets. Each 

diff --git a/liquibase-dist/src/main/archive/README.txt b/liquibase-dist/src/main/archive/README.txt
@@ -45,7 +45,7 @@ As Liquibase ships with an h2 database example, the h2 jdbc driver was placed in
 your chosen installation directory.
 
 For information on using and configuring the h2 database see: 
-https://docs.liquibase.com/install/tutorials/h2.html
+https://contribute.liquibase.com/extensions-integrations/directory/database-tutorials/h2/
 
 
 Open JDK

diff --git a/liquibase-standard/src/main/java/liquibase/Contexts.java b/liquibase-standard/src/main/java/liquibase/Contexts.java
@@ -12,7 +12,7 @@
  * migration run. Any string can be used for the context name and they are checked case-insensitively.
  * </p>
  *
- * @see <a href="https://docs.liquibase.com/concepts/advanced/contexts.html" target="_top">contexts</a> in documentation
+ * @see <a href="https://docs.liquibase.com/concepts/changelogs/attributes/contexts.html" target="_top">contexts</a> in documentation
  */
 public class Contexts {
 

diff --git a/liquibase-standard/src/main/java/liquibase/LabelExpression.java b/liquibase-standard/src/main/java/liquibase/LabelExpression.java
@@ -14,7 +14,7 @@
  * name, and it is case-insensitive.
  * </p>
  *
- * @see <a href="https://docs.liquibase.com/concepts/advanced/labels.html" target="_top">labels</a> in documentation
+ * @see <a href="https://docs.liquibase.com/concepts/changelogs/attributes/labels.html" target="_top">labels</a> in documentation
  */
 public class LabelExpression {
 

diff --git a/liquibase-standard/src/main/java/liquibase/Liquibase.java b/liquibase-standard/src/main/java/liquibase/Liquibase.java
@@ -154,7 +154,7 @@ public ResourceAccessor getResourceAccessor() {
     /**
      * Convenience method for {@link #update(Contexts)} that runs in "no context mode".
      *
-     * @see <a href="https://docs.liquibase.com/concepts/advanced/contexts.html" target="_top">contexts</a> in documentation
+     * @see <a href="https://docs.liquibase.com/concepts/changelogs/attributes/contexts.html" target="_top">contexts</a> in documentation
      */
     @Deprecated
     public void update() throws LiquibaseException {
@@ -165,7 +165,7 @@ public void update() throws LiquibaseException {
      * Convenience method for {@link #update(Contexts)} that constructs the Context object from the passed string.
      * To run in "no context mode", pass a null or empty "".
      *
-     * @see <a href="https://docs.liquibase.com/concepts/advanced/contexts.html" target="_top">contexts</a> in documentation
+     * @see <a href="https://docs.liquibase.com/concepts/changelogs/attributes/contexts.html" target="_top">contexts</a> in documentation
      */
     @Deprecated
     public void update(String contexts) throws LiquibaseException {
@@ -176,7 +176,7 @@ public void update(String contexts) throws LiquibaseException {
      * Executes Liquibase "update" logic which ensures that the configured {@link Database} is up to date according to
      * the configured changelog file. To run in "no context mode", pass a null or empty context object.
      *
-     * @see <a href="https://docs.liquibase.com/concepts/advanced/contexts.html" target="_top">contexts</a> in documentation
+     * @see <a href="https://docs.liquibase.com/concepts/changelogs/attributes/contexts.html" target="_top">contexts</a> in documentation
      */
     @Deprecated
     public void update(Contexts contexts) throws LiquibaseException {

diff --git a/liquibase-standard/src/main/java/liquibase/command/core/GenerateChangelogCommandStep.java b/liquibase-standard/src/main/java/liquibase/command/core/GenerateChangelogCommandStep.java
@@ -28,7 +28,7 @@ public class GenerateChangelogCommandStep extends AbstractCommandStep {
 
     private static final String INFO_MESSAGE =
             "BEST PRACTICE: When generating formatted SQL changelogs, always check if the 'splitStatements' attribute" + System.lineSeparator() +
-            "works for your environment. See https://docs.liquibase.com/commands/generatechangelog.html for more information. ";
+            "works for your environment. See https://docs.liquibase.com/commands/inspection/generate-changelog.html for more information. ";
 
     public static final CommandArgumentDefinition<String> AUTHOR_ARG;
     public static final CommandArgumentDefinition<String> CONTEXT_ARG;

diff --git a/liquibase-standard/src/main/java/liquibase/integration/servlet/GenericServletListener.java b/liquibase-standard/src/main/java/liquibase/integration/servlet/GenericServletListener.java
@@ -29,7 +29,7 @@
  * Servlet listener than can be added to web.xml to allow Liquibase to run on every application server startup.
  * Using this listener allows users to know that they always have the most up to date database, although it will
  * slow down application server startup slightly.
- * See the <a href="https://docs.liquibase.com/tools-integrations/community-supported/servlet-listener.html">Liquibase documentation</a> for
+ * See the <a href="https://contribute.liquibase.com/extensions-integrations/directory/integration-docs/servlet-listener/">Liquibase documentation</a> for
  * more information.
  *
  * @see LiquibaseJakartaServletListener

diff --git a/liquibase-standard/src/main/java/liquibase/parser/core/xml/LiquibaseEntityResolver.java b/liquibase-standard/src/main/java/liquibase/parser/core/xml/LiquibaseEntityResolver.java
@@ -108,7 +108,7 @@ private void warnForMismatchedXsdVersion(String systemId) {
                     String xsdVersion = versionMatcher.group("version");
                     if (!buildVersion.startsWith(xsdVersion)) {
                         hasWarnedAboutMismatchedXsdVersion = true;
-                        String msg = "INFO: An older version of the XSD is specified in one or more changelog's <databaseChangeLog> header. This can lead to unexpected outcomes. If a specific XSD is not required, please replace all XSD version references with \"-latest\". Learn more at https://docs.liquibase.com";
+                        String msg = "INFO: An older version of the XSD is specified in one or more changelog's <databaseChangeLog> header. This can lead to unexpected outcomes. If a specific XSD is not required, please replace all XSD version references with \"-latest\". Learn more at https://docs.liquibase.com/concepts/changelogs/xml-format.html";
                         Scope.getCurrentScope().getLog(getClass()).info(msg);
                         Scope.getCurrentScope().getUI().sendMessage(msg);
                     }

diff --git a/liquibase-standard/src/main/resources/liquibase/i18n/liquibase-core.properties b/liquibase-standard/src/main/resources/liquibase/i18n/liquibase-core.properties
@@ -42,8 +42,8 @@ no.deployment.ids.found=No deployment IDs were located.  No rollbacks were perfo
 no.change.sets.found.for.deployment.id=No changesets were located matching deployment ID '%s'.  No rollbacks were performed.
 deployment.id.required=You must specify the deployment ID.
 no.executor.pro.license.found=The Executor '%s' requires a Liquibase Pro license, available at https://www.liquibase.com/pricing or sales@liquibase.com. Options include the liquibase.licenseKey in the defaults file, adding a flag in the CLI, and more. Learn more at https://docs.liquibase.com.
-no.parameter.pro.license.found=Using '%s' in the '%s' parameter requires a valid Liquibase Pro license.\nGet a free Pro license key at https://liquibase.com/trial and add liquibase.licenseKey=<yourKey> into your defaults file or\nuse --pro-license-key=<yourKey> before your command in the CLI.
-no.pro.license.found=Using '%s' requires a valid Liquibase Pro license.\nGet a free Pro license key at https://liquibase.com/trial and add liquibase.licenseKey=<yourKey> into your defaults file or\nuse --pro-license-key=<yourKey> before your command in the CLI.
+no.parameter.pro.license.found=Using '%s' in the '%s' parameter requires a valid Liquibase Pro license.\nGet a free Pro license key at https://liquibase.com/trial and add liquibase.licenseKey=<yourKey> into your defaults file or\nuse --license-key=<yourKey> before your command in the CLI.
+no.pro.license.found=Using '%s' requires a valid Liquibase Pro license.\nGet a free Pro license key at https://liquibase.com/trial and add liquibase.licenseKey=<yourKey> into your defaults file or\nuse --license-key=<yourKey> before your command in the CLI.
 attempt.to.delete.the.file.failed.cannot.continue=Attempt to delete the file '%s' failed. Cannot continue. Sorry.
 successfully.released.database.change.log.locks=Successfully released all database change log locks for '%s'
 successfully.tagged=Successfully tagged '%s'

diff --git a/...ase-standard/src/test/groovy/liquibase/parser/core/xml/LiquibaseEntityResolverTest.groovy b/...ase-standard/src/test/groovy/liquibase/parser/core/xml/LiquibaseEntityResolverTest.groovy
@@ -50,7 +50,7 @@ class LiquibaseEntityResolverTest extends Specification {
 
         // This is an ugly assertion line, it is essentially saying, either we expect the message, so make sure it's there
         // or we expect no message, so make sure there are no messages.
-        ((expectedWarningMessage && uiService.getMessages().contains("INFO: An older version of the XSD is specified in one or more changelog's <databaseChangeLog> header. This can lead to unexpected outcomes. If a specific XSD is not required, please replace all XSD version references with \"-latest\". Learn more at https://docs.liquibase.com"))
+        ((expectedWarningMessage && uiService.getMessages().contains("INFO: An older version of the XSD is specified in one or more changelog's <databaseChangeLog> header. This can lead to unexpected outcomes. If a specific XSD is not required, please replace all XSD version references with \"-latest\". Learn more at https://docs.liquibase.com/concepts/changelogs/xml-format.html"))
         || (!expectedWarningMessage && uiService.getMessages().isEmpty()))
 
         cleanup: