[GitHub] [hudi] vingov commented on pull request #3776: [WIP]: added guides section

[GitBox <gi...@apache.org>]

vingov commented on pull request #3776:
URL: https://github.com/apache/hudi/pull/3776#issuecomment-939722960


   @pratyakshsharma - there are few changes required to fix the build, please apply this patch to make it work.
   
   ```
   diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
   index b5b0af7e6..3496aa32b 100644
   --- a/website/docusaurus.config.js
   +++ b/website/docusaurus.config.js
   @@ -65,6 +65,16 @@ module.exports = {
            showLastUpdateTime: false,
          },
        ],
   +    [
   +      '@docusaurus/plugin-content-docs',
   +      {
   +        id: 'guides',
   +        path: 'guides',
   +        routeBasePath: 'guides',
   +        showLastUpdateAuthor: false,
   +        showLastUpdateTime: false,
   +      },
   +    ],
        [
          '@docusaurus/plugin-client-redirects',
          {
   diff --git a/website/guides/troubleshooting-guide.md b/website/guides/troubleshooting-guide.md
   index 26dcd1913..d6fde30f9 100644
   --- a/website/guides/troubleshooting-guide.md
   +++ b/website/guides/troubleshooting-guide.md
   @@ -1,5 +1,5 @@
    ---
   -title: "Troubleshooting Guide"
   +title: Troubleshooting Guide
    keywords: [hudi, tuning, performance]
    last_modified_at: 2021-09-29T15:59:57-04:00
    ---
   @@ -24,7 +24,7 @@ For such errors, please try to ensure only valid data type conversions are happe
    
    Sample stacktrace when trying to evolve a field from Long type to Integer type with Hudi : https://gist.github.com/nsivabalan/0d81cd60a3e7a0501e6a0cb50bfaacea
    
   -### org.apache.hudi.exception.SchemaCompatabilityException: Unable to validate the rewritten record <record> against schema <schema> at org.apache.hudi.common.util.HoodieAvroUtils.rewrite(HoodieAvroUtils.java:215)
   +### org.apache.hudi.exception.SchemaCompatabilityException: Unable to validate the rewritten record &lt;record&gt; against schema &lt;schema&gt; at org.apache.hudi.common.util.HoodieAvroUtils.rewrite(HoodieAvroUtils.java:215)
    
    This can possibly occur if your schema has some non-nullable field whose value is not present or is null. It is recommended to evolve schema in backwards compatible ways. In essence, this means either have every newly added field as nullable or define default values for every new field. In case if you are relying on default value for your field, as of Hudi version 0.5.1, this is not handled. 
    
   @@ -78,7 +78,7 @@ This will usually happen when you are trying to add a new column to existing hiv
    set hive.metastore.disallow.incompatible.col.type.changes=false;
    ```
    
   -### com.uber.hoodie.hive.HoodieHiveSyncException: Could not convert field Type from <type1> to <type2> for field col1
   +### com.uber.hoodie.hive.HoodieHiveSyncException: Could not convert field Type from &lt;type1&gt; to &lt;type2&gt; for field col1
    
    This occurs because HiveSyncTool currently supports only few compatible data type conversions. Doing any other incompatible change will throw this exception. Please check the data type evolution for the concerned field and verify if it indeed can be considered as a valid data type conversion as per Hudi code base.
    
   diff --git a/website/guides/tuning-guide.md b/website/guides/tuning-guide.md
   index e0dabd091..581778aa9 100644
   --- a/website/guides/tuning-guide.md
   +++ b/website/guides/tuning-guide.md
   @@ -1,5 +1,5 @@
    ---
   -title: "Tuning Guide"
   +title: Tuning Guide
    keywords: [hudi, tuning, performance]
    last_modified_at: 2021-09-29T15:59:57-04:00
    ---
   
   ```


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org