update: index.md + migration

Author: timurbazhirov

lang/en/docs/index.md

@@ -1,42 +1,54 @@
 # Mat3ra Documentation
 
-[**Mat3ra**](https://platform.mat3ra.com) is a cloud-native accessible and collaborative platform for materials modeling from the atomic scale. Our platform makes it easier for scientists, engineers, and researchers to **design new materials** and **predict their properties** using *first-principles* approaches and *AI/ML* techniques. 
-
-First-principles approach does not require any knowledge of experimental observations, instead solely takes into account the atomistic description of material (e.g., constituent atoms, crystal structure, lattice constant, etc.) to compute desired properties thanks to [Density Functional Theory](https://en.wikipedia.org/wiki/Density_functional_theory){:target='_blank'} and its numerical implementations. When enough data is present, the AI/ML techniques can be applied to discover trends and accelerate predictions. Our platform also helps users collaborate, share and gather obtained knowledge with others. 
-
-The present documentation explains how the platform works in detail.
+Mat3ra is a platform for materials modeling from the atoms up. This documentation explains how to use the platform to
+design new materials and predict their properties using physics-based and AI/ML models powered by cloud HPC.
 
+!!!note "Migrating to the New Platform (Q4 2025)"
+    Existing users: see [Migrating to the New Platform](migrating-to-new-platform.md) for timelines and guidance.
 
 ## Quick start
 
-You can skip straight to our tutorial summarizing [first steps](getting-started/run-first-simulation/web-interface.md). There you will learn how to set up and run [density functional theory](models-directory/dft/overview.md) calculation to obtain [electronic band structure](properties-directory/non-scalar/bandstructure.md) of silicon, a semiconducting material widely used in making electronic chips.
-
+- [Run your first simulation (web)](getting-started/run-first-simulation/web-interface.md)
+- [Run your first CLI job](getting-started/run-first-simulation/cli-job.md)
+- [Content highlights](getting-started/content-highlights.md)
+
+## Popular topics
+
+- **Access the platform**: [Platform access guide](tutorials/platform-access.md)
+- **Jobs via CLI**: [Overview](jobs-cli/overview.md) · Batch scripts
+  ([Overview](jobs-cli/batch-scripts/overview.md),
+  [General structure](jobs-cli/batch-scripts/general-structure.md),
+  [Directives](jobs-cli/batch-scripts/directives.md),
+  [Working directory](jobs-cli/batch-scripts/directories.md),
+  [Apptainer & Modules](jobs-cli/batch-scripts/apptainer.md),
+  [Samples](jobs-cli/batch-scripts/sample-scripts.md))
+- **Remote connection**: [SSH](remote-connection/ssh.md) · [Web Terminal](remote-connection/web-terminal.md) ·
+  [Remote Desktop](remote-connection/remote-desktop.md)
+- **Data locations and quotas**: [Data on disk: directories](data-on-disk/directories.md) ·
+  [Quotas](data-on-disk/quotas.md)
+- **Clusters**: [Overview](infrastructure/clusters/overview.md) ·
+  [Cluster-101 (free tier)](infrastructure/clusters/cluster-101.md) ·
+  [AWS](infrastructure/clusters/aws.md) · [Azure](infrastructure/clusters/azure.md) ·
+  [GCP](infrastructure/clusters/google.md)
+- **Materials**: [Overview](materials/overview.md) · [Import from files](materials/import-from-files.md)
+- **Models**: [DFT overview](models-directory/dft/overview.md)
+- **Properties**: [Overview](properties/overview.md) · [Band structure](properties-directory/non-scalar/bandstructure.md)
+- **Workflows**: [Overview](workflows/overview.md) · [Designer](workflow-designer/overview.md)
+- **REST API**: [Overview](rest-api/overview.md)
 
 ## Searching
 
-If you are looking for a specific topic of interest, please use the search box on top to quickly locate relevant pages.
-
-The [Links](#links) section below lists resources containing more in-depth explanations about what we are building and why[^1] and example case studies[^2].
-
+Use the search box at the top to quickly find specific topics across the documentation.
 
-## Contents
-
-The navigation bar on the left serves as the table of contents for the whole documentation while the table of contents on the right lists content headers under the current page. You may click on any top-level items on the left sidebar to expand the corresponding section. The [content highlights page](getting-started/content-highlights.md) has a brief overview of various features available in Mat3ra platform and links to them.
+## How this site is organized
 
+The left sidebar is the global table of contents. Click any top-level item to expand sections. For a high-level tour of
+major features, see [Content highlights](getting-started/content-highlights.md).
 
 ## Support
 
-We reply to support requests within 24 hours. Our team can be contacted during working hours Pacific Time through:
-
-- Email: <a href="mailto:[email protected]" target="_blank">[email protected]</a>
-- Phone: +1 (510) 473-7770
-- Via web widget: click **Support** button at the bottom of our <a href="https://platform.mat3ra.com" target="_blank">web application</a>.
-
-!!! tip "Let us hear your feedback"
-    In case you find that something is missing or if you still have questions after reading this documentation, please <a class="text-muted" href="mailto:[email protected]" target="_blank">contact us</a>.
-
-
-## Links
+We respond to support requests within 24 hours during working hours (Pacific Time). See
+[Help & Support](other/support.md) for ways to get assistance.
 
-[^1]: [What is materials discovery cloud, article](https://www.linkedin.com/pulse/how-we-design-world-tomorrow-what-materials-discovery-timur-bazhirov)
-[^2]: [Mat3ra: case studies](https://mat3ra.com/case-studies)
+!!! tip "Help us improve"
+If something is missing or unclear, please open the [Help & Support](other/support.md) page and get in touch.

lang/en/docs/migrating-to-new-platform.md

@@ -6,7 +6,7 @@ We are excited to announce the immediate availability of the new iteration of th
 upgrade over previous monthly releases and introduces new infrastructure, compute options, and improvements to the
 overall user experience.
 
-!!! note "Important": For a smooth transition, both the old and the new platform versions will remain operational
+!!!note "Important": For a smooth transition, both the old and the new platform versions will remain operational
 through the end of 2025. See the timeline below.
 
 ---