Substrait FAQ Page

[vibhatha]

There are frequently asked questions which can be included in a separate page on the main website. I propose, it is better to group such a set of questions which have already been asked and create this page.

[vibhatha]

cc @westonpace @jacques-n @ianmcook

[westonpace]

It sounds like you are proposing that the three questions on the main page be moved to a dedicated page? I think that would be ok. However, the navigation list (home, spec, types, expressions, ...) is starting to get quite long, and adding an FAQ item is just going to make it longer. At one point I think @jacques-n recommended changing this to a two level list. For example, maybe something like:

• Home
  • Introduction
  • FAQ
• Spec
  • Introduction
  • Types
  • Expressions
  • Relations
  • Serialization
  • Extensions
• Community
  • How to get Involved
  • Governance

Are you also suggesting we add more questions?

[vibhatha]

FAQ could be a nice thing to go along side the introduction or community. Since FAQs are rather created by the community involvement than by maintainers themselves.

Also FAQ is something that could evolve with time. I would say it needs to be updated quarterly or annually or whenever we see the same question being asked multiple times in mailing list, etc. This last bit is just a suggestion. What you suggested is more than sufficient for the current stage.