Optimize the module structure of the xtable about incubator-xtable

[daragu]

hi @the-other-tim-brown @sagarlakshmipathy @vinishjail97, what do you think?

https://github.com/daragu/incubator-xtable/tree/module

[the-other-tim-brown]

What is the enhancement that comes with this? It feels a bit arbitrary.

[daragu]

What is the enhancement that comes with this? It feels a bit arbitrary.

Hi @the-other-tim-brown, well, I think I& a couple of points.

1. For mvn projects, add same prefix to sub modules is friendly for developers.

• Development best practices: it is impossible to deploy two modules having the same name. To avoid this kind of conflict, we recommend to prefix all modules of a project by a common key referring to the project (example : "xtable-aaa, xtable-bbb").
• After this modification, developers can quickly determine which folders in this project are submodules and which folders are regular folders by using the prefix of the folder
  e.g
  • https://github.com/apache/flink
  • https://github.com/apache/hudi
  • https://github.com/apache/paimon
  • https://github.com/spring-projects/spring-framework

3. For Xtable project users

From the official docs, user will use utilities/target/utilities-0.1.0-SNAPSHOT-bundled.jar to convert data lake formats

java -jar utilities/target/utilities-0.1.0-SNAPSHOT-bundled.jar --datasetConfig my_config.yaml

The name utilities-0.1.0-SNAPSHOT-bundled.jar does not have recognizability. The new name xtable-utilities-0.1.0-SNAPSHOT-bundled.jar is more recognizable.

[the-other-tim-brown]

@daragu thanks for the references and explanation. The changes sound good to me. The only thing is that the website directory is not maven module. Should that just stay as website for now? It may be moved in the future when we rethink how to manage the docs.

[daragu]

OK, the website directory will stay as website in the pullrequest.