From 6631a0427b41d39ac0ab00dd8ca901579dd3c886 Mon Sep 17 00:00:00 2001
From: James Kent <jamesdkent21@gmail.com>
Date: Fri, 1 May 2026 14:29:43 -0500
Subject: [PATCH] add new FAQs

---
 docs/introduction/faq.md    | 28 +++++++++++++++++++++++++++-
 docs/introduction/index.mdx | 19 ++++++++++++++++---
 2 files changed, 43 insertions(+), 4 deletions(-)

diff --git a/docs/introduction/faq.md b/docs/introduction/faq.md
index 6b73f6f..0bd7af1 100644
--- a/docs/introduction/faq.md
+++ b/docs/introduction/faq.md
@@ -37,4 +37,30 @@ You may also make a Version private if you don't want to share your edits with o
 <details>
 <summary>How does this project relate to the original Neurosynth?</summary>
 Neurosynth 1.0 was an online platform for browsing automatically generated large-scale neuroimaging meta-analyses. However, because all analyses were pre-generated, users were unable to define custom meta-analyses using the Neurosynth database. Instead, Neurosynth 1.0 used text mining techniques to automatically group studies based on the frequency of the terms mentioned in the text. Neurosynth Compose is focused on allowing users to overcome the limitations of automated large-scale meta-analysis, by enabling users to annotate studies, and curate sets of studies amenable for meta-analysis. This way, users can systematically define meta-analyses using their own expertise, while still leveraging the Neurosynth database, and an easy-to-use web-based analysis builder to accelerate the meta-analysis process.<br/>
-</details>
\ No newline at end of file
+</details>
+
+<details>
+<summary>How do I collaborate with another person on the same meta-analysis project?</summary>
+The answer depends on what you want your collaborator(s) to be able to do.
+If you just want them to view the project, you can make the project public and share the Project URL with them.
+If you want them to be able to edit the project, the best approach is to create a shared account
+using a shared email address and create the project under that account.
+It is on our roadmap to provide more robust collaboration features in the future.
+</details>
+
+<details>
+<summary>How do I run a legacy Neurosynth-like meta-analysis?</summary>
+Use the <a href="../tutorial/automated">Automated Meta-Analysis tutorial</a> as the closest workflow. In brief: create a Project, use the Simple curation workflow, import studies from NeuroStore using your search term, promote the relevant studies to Included, move to Extraction, and then create a Meta-Analysis Specification. Using the search term is similar to the tf-idf approach used in the original Neurosynth platform since the threshold for inclusion was so low, if the word was mentioned in the abstract, it would be included.
+<br/><br/>
+For the algorithm, select `MKDAChi2`. This is the large-scale association-test workflow used by the original Neurosynth platform. When prompted for a reference dataset, choose `Neurosynth` if you want the legacy Neurosynth reference sample, or `Neurostore` if you want the newer continuously updated database.
+</details>
+
+
+<details>
+<summary>What's an annotation?</summary>
+An annotation is a column of structured information attached to the Analyses in a StudySet. You can think of annotations like a spreadsheet: rows are Analyses, and columns are values such as `included`, task type, contrast direction, participant group, or any other variable you need for curation and analysis.
+<br/><br/>
+Annotations are most often used to decide which Analyses should be included in a meta-analysis. For example, a Boolean annotation can mark each Analysis as included or excluded, and the Meta-Analysis Specification step can use that annotation column to select the final inputs.
+<br/><br/>
+See the <a href="../guide/glossary#annotation">Glossary entry on Annotations</a> and the <a href="../guide/Project/Extraction#annotations">Extraction guide</a> for more detail.
+</details>
diff --git a/docs/introduction/index.mdx b/docs/introduction/index.mdx
index 36c30f2..3e483ec 100644
--- a/docs/introduction/index.mdx
+++ b/docs/introduction/index.mdx
@@ -24,8 +24,8 @@ import Typography from '@mui/material/Typography';
 ## Get started! 🚀 
 
 
-<div style={{ display: 'flex' }}>
-  <Card style={{ width: '100%', display: 'flex', marginRight: '50px' }}>
+<div style={{ display: 'flex', gap: '24px', flexWrap: 'wrap' }}>
+  <Card style={{ flex: '1 1 240px', display: 'flex' }}>
     <CardContent>
       <Typography variant="h5" component="h2" gutterBottom>
         Tutorials
@@ -38,7 +38,7 @@ import Typography from '@mui/material/Typography';
       </Button>
     </CardContent>
   </Card>
-  <Card style={{ width: '100%', display: 'flex' }}>
+  <Card style={{ flex: '1 1 240px', display: 'flex' }}>
     <CardContent>
       <Typography variant="h5" component="h2" gutterBottom>
         User Guide
@@ -51,6 +51,19 @@ import Typography from '@mui/material/Typography';
       </Button>
     </CardContent>
   </Card>
+  <Card style={{ flex: '1 1 240px', display: 'flex' }}>
+    <CardContent>
+      <Typography variant="h5" component="h2" gutterBottom>
+        FAQ
+      </Typography>
+      <Typography variant="body1" gutterBottom>
+        Find answers to common questions about collaboration, automated analyses, algorithms, and annotations.
+      </Typography>
+      <Button variant="contained" color="primary" href="introduction/faq">
+        Go to FAQ
+      </Button>
+    </CardContent>
+  </Card>
 </div>
 
 <Card style={{ marginTop: '24px' }}>