ref

Author: githubering182

docs/projects.md

@@ -5,8 +5,6 @@ Each project defines its own label system, goals, and data scope.
 
 <!-- <img src="/docs/assets/" alt="project_main"> -->
 
----
-
 ## 🔹 What is a Project?
 
 A project groups:
@@ -16,8 +14,6 @@ A project groups:
 - [Collection goals (per label)](/docs/goals.md)
 - [Assigned users with roles](/docs/users.md)
 
----
-
 ## 📤 Creating a Project
 
 Only admin/superusers can create new projects via the UI or API.
@@ -53,8 +49,6 @@ Each project has the following sections:
 
 More of that below
 
----
-
 ## 👥 Roles & Access
 
 Users are split by admin/ non admin ones.
@@ -66,8 +60,6 @@ so you need to manually edit the permissions for it if needed.
 
 See [Users & Roles](/docs/users.md) for how to manage users and set permissions
 
----
-
 ## 🖼️ Uploading
 
 After creating you can upload images or videos.
@@ -78,8 +70,6 @@ Note: media processing on the server side may cause a slight delay before visibi
 
 See [Uploads](/docs/uploads.md) for how to upload media
 
----
-
 ## 📝 Validation
 
 When you are done with uploading you can validate this data whether it's applicable to your project or not.
@@ -89,8 +79,6 @@ Labels could be corrected there too.
 
 See [Validation](/docs/validation.md) for how to validate/ see uploaded images
 
----
-
 ## 🧩 Label Schema
 
 Each project might have a label schema, defining what’s being collected. Labels can be:
@@ -104,8 +92,6 @@ Each project might have a label schema, defining what’s being collected. Label
 
 See [Labels](/docs/labels.md) for how to create and assign them.
 
----
-
 ## 🎯 Goals
 
 Optionally, you can define target counts for labels (e.g. "Need 100 images of `Dog`").
@@ -114,8 +100,6 @@ Optionally, you can define target counts for labels (e.g. "Need 100 images of `D
 
 See [Goals](/docs/goals.md) for how to create and track them.
 
----
-
 ## 📊 Stats & Progress
 
 Each project has a brief dashboard shows the collected count grouped by:
@@ -127,8 +111,6 @@ Each project has a brief dashboard shows the collected count grouped by:
 
 See [Statistics](/docs/statistics.md)
 
----
-
 ## 🗃 Downloading Results
 
 You can export annotated datasets as `.zip` archives with optional filters
@@ -137,8 +119,6 @@ You can export annotated datasets as `.zip` archives with optional filters
 
 See [Downloads](/docs/downloads.md) for how to request archives
 
----
-
 ## ⚙️ Edit project
 
 You can at any time change project info, labels, permissions or delete the Project.

docs/quickstart.md

@@ -9,23 +9,28 @@ This guide walks you through setting up and using ISS Data Collection Tool local
 ```bash
 git clone https://github.com/ISSResearch/Data-Collection-Tool.git
 cd data-collection-tool
-cp .env.sample .env
-make build
 ```
 
-Make sure make, Docker, and Docker Compose are installed.
-Edit the .env file to suit your environment before proceeding.
+## 2. Build images
+
+```bash
+make build
+```
 
-## 2. Start in Prod Mode
+## 3. Start in Prod Mode
 
 ```bash
+cp .env.sample .env
 make start
 ```
 
+Make sure make, Docker, and Docker Compose are installed.
+Edit the .env file to suit your environment before proceeding.
+
 This command starts all services in production mode using Docker Compose.
 The project will be accessible at http://localhost:8000 (default port).
 
-## 3. Create admin user
+## 4. Create admin user
 ```bash
 make init-admin
 ```
@@ -34,5 +39,7 @@ You must create a superuser before accessing the UI.
 Only admin users can currently create new projects and manage roles/permissions.
 More about that in [Users and Roles](/docs/users.md)
 
+---
+
 ## ✅ Next Step
 [Project](/docs/projects.md)