Skip to content

Docs/improve landing page #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jhagberg wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Docs/improve landing page #7

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 15 additions & 20 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
# SciLifeLab Architecture Board
# Architecture Guidance for SciLifeLab

> Ensuring interoperable, sustainable, and FAIR infrastructure across SciLifeLab's federated platforms.

The Architecture Board provides technical governance and guidance for SciLifeLab infrastructure, enabling seamless collaboration while respecting platform autonomy. We support decision-making for technical architecture across all SciLifeLab platforms and services.
> Get expert help designing interoperable, sustainable, and FAIR infrastructure across SciLifeLab's federated platforms.

!!! question "Need Architecture Help?"

Expand All @@ -14,30 +12,25 @@ The Architecture Board provides technical governance and guidance for SciLifeLab
[:octicons-comment-discussion-16: Start a Discussion](https://github.com/SciLifeLab/architecture/discussions){ .md-button }
[:octicons-mail-16: architecture@scilifelab.se](mailto:architecture@scilifelab.se){ .md-button }

## What We Do
## How We Can Help

| Situation | What You'll Get |
| --------------------------------- | ------------------------------------------------------- |
| Starting a new project | Guidance on technology choices and integration patterns |
| Designing cross-platform features | Coordination support and best practices |
| Facing a technical decision | Review and documented recommendation (ADR) |
| Unsure about standards | Clarification on SciLifeLab technical conventions |

```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#a7c947', 'primaryTextColor': '#1a1a1a', 'primaryBorderColor': '#8bb030', 'lineColor': '#045c64', 'secondaryColor': '#e8f5e9', 'tertiaryColor': '#f5f5f5', 'fontFamily': 'Open Sans'}}}%%
graph LR
A[Project Team] -->|Question| B[Architecture Board]
A[Your Team] -->|Question| B[Architecture Board]
B -->|Guidance| A
B -->|Decision| C[ADR]
C -->|Published| D[Documentation]
D -->|Informs| A
```

### :material-compass: Architecture Guidance

Best practices for technical design, integration patterns, and technology choices.

### :material-file-document-edit: Decision Records

Transparent documentation of all significant architectural decisions (ADRs).

### :material-connection: Cross-Platform Coordination

Facilitate collaboration to ensure coherent architecture across SciLifeLab.

## Recent Decisions

| Decision | Status | Summary |
Expand All @@ -47,7 +40,9 @@ Facilitate collaboration to ensure coherent architecture across SciLifeLab.
| [ADR-0002: CC BY-SA 4.0](decisions/0002-use-cc-by-sa-4-0-license.md) | Accepted | Use CC BY-SA 4.0 license for content |
| [ADR-0001: Record Decisions](decisions/0001-record-architecture-decisions.md) | Accepted | Record architecture decisions as ADRs |

## Board Members
## About the Architecture Board
Copy link
Member

@alneberg alneberg Jan 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we still want to keep the name 'Architecture Board' here? I just noticed you changed it in the index header.


The Architecture Board provides technical governance and guidance for SciLifeLab infrastructure, enabling seamless collaboration while respecting platform autonomy.

| Name | Affiliation | Role |
| ----------------- | ----------- | -------------------------------------------------------------------------------------------------------------------- |
Expand All @@ -65,7 +60,7 @@ The Architecture Board welcomes input from all SciLifeLab teams and the broader

!!! tip "How to Contribute"

1. **Not sure yet?** Start a [GitHub Discussion](https://github.com/SciLifeLab//architecture/discussions) or email [architecture@scilifelab.se](mailto:architecture@scilifelab.se)
1. **Not sure yet?** Start a [GitHub Discussion](https://github.com/SciLifeLab/architecture/discussions) or email [architecture@scilifelab.se](mailto:architecture@scilifelab.se)
2. **Have a question?** Open a [GitHub Issue](https://github.com/SciLifeLab/architecture/issues) to get guidance
3. **Proposing a change?** Create an ADR following our [template](decisions/0001-record-architecture-decisions.md)
4. **Found an issue?** Submit a pull request with your suggested improvements
Expand Down