Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .agent/working-memory/plan-awesome-list.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**Date:** 2026-03-28
**Source repo:** https://github.com/openmodelingfoundation/awesome-modeling-practices
**Target page:** `/resources/awesome-modeling-practices/` (new section, or under `/standards/`)
**Target page:** `/resources/awesome-modeling-practices/`

---

Expand Down
38 changes: 38 additions & 0 deletions .agent/working-memory/plan-navigation-resources-refactor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Promote Working Groups to Top-Level Navigation and Add a Resources Index

## Summary

Move Working Groups out of About and make it a top-level section. Add a new top-level Resources page that acts as an index of OMF outputs. Keep `/standards/` as the canonical home for standards content; `/resources/` should link to it rather than duplicating it.

## Proposed changes

- Move `content/en/about/working-groups/` to `content/en/working-groups/`.
- Add Hugo aliases for every moved Working Groups page so existing `/about/working-groups/...` URLs keep working.
- Create `content/en/resources/_index.md` plus minimal child pages for publications, best practices, and repositories.
- Add a featured Standards link on `/resources/` that points to `/standards/`.
- Make the top nav order explicit: About, Governance, Working Groups, Standards, Resources, Contribute.
- Update internal links that still point to `/about/working-groups/`.

## Constraints

- Navigation is currently driven by section front matter `menu.main`, not a centralized `menus.main` block in `hugo.yaml`.
- Avoid a duplicate top-level menu definition unless existing section `menu.main` entries are removed.
- Keep this as a content/front matter refactor; do not rewrite templates unless the move exposes a real theme limitation.
- Validate with the containerized build path: `make render`.

## Acceptance criteria

- Working Groups appears in the top-level nav and is no longer nested under About.
- Resources appears in the top-level nav.
- `/working-groups/` is canonical.
- Old Working Groups URLs under `/about/working-groups/...` resolve via aliases.
- `/resources/` exists as an outputs index.
- `/resources/` includes a Standards block linking to `/standards/`.
- `/resources/` includes links for publications, best practices, and repositories, including `openmodelingfoundation/awesome-modeling-practices`.
- The site builds successfully with `make render`.

## Implementation notes

- Add aliases to every moved Working Groups page, not just the section landing page.
- Known internal links to update include `content/en/_index.html` and `content/en/about/history-events-and-activities.md`.
- Do not add a `standards-documents` subsection under Resources.
1 change: 1 addition & 0 deletions .agent/working-memory/session.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
## Active task

- awesome-modeling-practices embed plan is ready: `.agent/working-memory/plan-awesome-list.md`.
- navigation/resources refactor issue plan is ready: `.agent/working-memory/plan-navigation-resources-refactor.md`.
- Next step on request: implement the planned integration.

## Notes by date (newest first)
Expand Down
2 changes: 1 addition & 1 deletion .env
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
HUGO_VERSION="v0.159.1"
HUGO_VERSION="v0.160.1"
DOCSY_VERSION="v0.14.3"
2 changes: 2 additions & 0 deletions .github/workflows/gh-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -49,12 +49,14 @@ jobs:
env:
BASE_URL: ${{ steps.pages.outputs.base_url }}
run: |
BUILD_TIMESTAMP_UTC="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
docker compose build --pull hugo
docker compose run --rm --no-deps \
--entrypoint sh \
--user "$(id -u):$(id -g)" \
-e HUGO_CACHEDIR="${HUGO_CACHE_CONTAINER_DIR}" \
-e BASE_URL="${BASE_URL}" \
-e BUILD_TIMESTAMP_UTC="${BUILD_TIMESTAMP_UTC}" \
hugo -c '.github/scripts/build-site.sh'

- name: Save build cache
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Agent-generated artifacts must be written under `.agent/`.

## Important dependency versions

- Hugo (Docker build arg): `0.159.1` (`Dockerfile`)
- Hugo (Docker build arg): `0.160.1` (`Dockerfile`)
- Docsy module: `v0.14.3` (`go.mod` and `Dockerfile`)
- Go toolchain declaration: `1.18` (`go.mod`)
- npm package manifest version: `1.0.0` (`package.json`)
Expand Down
2 changes: 1 addition & 1 deletion Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
ARG HUGO_VERSION=v0.159.1
ARG HUGO_VERSION=v0.160.1
FROM ghcr.io/gohugoio/hugo:${HUGO_VERSION}

ARG DOCSY_VERSION=v0.14.3
Expand Down
102 changes: 102 additions & 0 deletions assets/scss/_styles_project.scss
Original file line number Diff line number Diff line change
Expand Up @@ -135,3 +135,105 @@ footer {
visibility: hidden;
}
}

.awesome-list-content {
max-width: 78ch;

.awesome-list-intro {
color: $gray-700;
font-size: 1.05rem;
margin-bottom: 1.25rem;
}

.awesome-list-meta {
border-left: 4px solid $secondary;
background: rgba($secondary, 0.06);
}

.awesome-list-rendered {
h2 {
margin-top: 2.25rem;
margin-bottom: 0.75rem;
padding-bottom: 0.35rem;
border-bottom: 2px solid rgba($primary, 0.2);
letter-spacing: 0.01em;
}

h3 {
margin-top: 1.5rem;
margin-bottom: 0.35rem;
font-size: 1.15rem;
}

p,
li {
line-height: 1.7;
}

> ul:first-of-type {
display: flex;
flex-wrap: wrap;
list-style: none;
gap: 0.5rem;
padding-left: 0;
margin: 1rem 0 1.5rem;

li {
margin: 0;
}

a {
display: inline-block;
font-size: 0.85rem;
line-height: 1.25;
text-decoration: none;
color: $primary;
background: rgba($secondary, 0.14);
border: 1px solid rgba($secondary, 0.35);
border-radius: 999px;
padding: 0.35rem 0.7rem;
transition: all 0.2s ease;
}

a:hover,
a:focus-visible {
background: rgba($secondary, 0.22);
border-color: rgba($secondary, 0.55);
outline: none;
}
}

ul {
padding-left: 1.25rem;
}

ul li {
margin-bottom: 0.55rem;
}

ul li::marker {
color: $secondary;
}

a {
text-underline-offset: 0.14em;
}

a:focus-visible {
outline: 2px solid rgba($secondary, 0.8);
outline-offset: 2px;
border-radius: 2px;
}
}

@include media-breakpoint-down(md) {
.awesome-list-rendered > ul:first-of-type {
gap: 0.4rem;

a {
font-size: 0.8rem;
padding: 0.3rem 0.58rem;
}
}
}
}
2 changes: 1 addition & 1 deletion content/en/_index.html
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ <h3 class="font-weight-light text-center">
{{< blocks/section color="light" type="row" >}}
{{% blocks/feature icon="fas fa-project-diagram" title="How to Participate" url="/contribute" url_text="How to contribute" %}}
You can [contribute to OMF activities]({{< relref "contribute" >}}) as a representative of a member organization or
as an individual in a [Working Group]({{< relref "working-groups" >}}).
as an individual in a [Working Group]({{< relref "/working-groups" >}}).
{{% /blocks/feature %}}

{{% blocks/feature icon="fas fa-users" title="Community" url="/about/community" %}}
Expand Down
2 changes: 1 addition & 1 deletion content/en/about/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ cascade:
- type: "docs"
menu:
main:
weight: 20
weight: 10
---

The Open Modeling Foundation (OMF) is an international open science community that works to enable the next generation modeling of human and natural systems. It is an alliance of modeling organizations that coordinates and administers a common, community developed body of standards and best practices among diverse communities of modeling scientists. The OMF also provides informational, data, and technological resources to facilitate the implementation of common standards and best practices among the scientific communities it serves.
Expand Down
2 changes: 1 addition & 1 deletion content/en/about/history-events-and-activities.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 101

## Upcoming Activities

Information on activities or projects of individual OMF Working Groups can be found within their individual pages accessed via the [Working Groups page]({{< ref "/about/working-groups#working-groups" >}}).
Information on activities or projects of individual OMF Working Groups can be found within their individual pages accessed via the [Working Groups page]({{< ref "/working-groups#working-groups" >}}).

**December 2024 Virtual Members Council Meeting**

Expand Down
2 changes: 1 addition & 1 deletion content/en/contribute/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ cascade:
- github_issue_filter: label:"OMF site info"
menu:
main:
weight: 20
weight: 60
---

The Open Modeling Foundation is using GitHub as a platform for members to contribute and modify content. With this platform, we hope to encourage collaboration and accessibility.
Expand Down
50 changes: 50 additions & 0 deletions content/en/resources/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: "Resources"
linkTitle: "Resources"
cascade:
- type: "docs"
menu:
main:
weight: 50
---

The Resources section highlights concrete Open Modeling Foundation outputs and related materials. Use it to find standards, publications, practical guidance, and repository-based resources without duplicating the main standards section.

<div class="row row-cols-1 row-cols-md-2 g-4 mt-1">
<div class="col">
<div class="card h-100 shadow-sm">
<div class="card-body">
<h2 class="h4 card-title">Standards</h2>
<p class="card-text">View OMF standards and guidance in the dedicated standards section.</p>
<a class="btn btn-primary" href="/standards/">View OMF standards</a>
</div>
</div>
</div>
<div class="col">
<div class="card h-100 shadow-sm">
<div class="card-body">
<h2 class="h4 card-title">Publications</h2>
<p class="card-text">Browse publications, manuscripts, and reports related to OMF activities.</p>
<a class="btn btn-outline-primary" href="{{< relref "publications" >}}">Browse publications</a>
</div>
</div>
</div>
<div class="col">
<div class="card h-100 shadow-sm border-primary-subtle">
<div class="card-body">
<h2 class="h4 card-title">Awesome Modeling Practices</h2>
<p class="card-text">Useful modeling resources curated by the OMF Early Career Scholars Working Group.</p>
<a class="btn btn-outline-primary" href="{{< relref "awesome-modeling-practices" >}}">Open awesome list</a>
</div>
</div>
</div>
<div class="col">
<div class="card h-100 shadow-sm">
<div class="card-body">
<h2 class="h4 card-title">Repositories</h2>
<p class="card-text">Explore OMF's GitHub repositories.</p>
<a class="btn btn-outline-primary" href="{{< relref "repositories" >}}">Browse repositories</a>
</div>
</div>
</div>
</div>
9 changes: 9 additions & 0 deletions content/en/resources/awesome-modeling-practices/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: "Awesome Modeling Practices"
linkTitle: "Awesome Modeling Practices"
description: "✨Awesome modeling practices✨ curated by the OMF Early Career Scholars Working Group."
layout: "awesome-list"
weight: 10
---

This page auto-imports the latest curated list from the OMF community repository.
10 changes: 10 additions & 0 deletions content/en/resources/publications.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: "Publications"
linkTitle: "Publications"
weight: 20
---

Publications and documents resulting from Open Modeling Foundation Working Group activities.

- [Ten simple rules for good model-sharing practices](https://doi.org/10.1371/journal.pcbi.1012702)
- Standards-related manuscripts and reports developed by OMF working groups will be added here as they are published.
12 changes: 12 additions & 0 deletions content/en/resources/repositories.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: "Repositories"
linkTitle: "Repositories"
type: "docs"
weight: 30
---

The following OMF repositories and open infrastructure welcome community contributions and oversight.

- This website's source: [openmodelingfoundation/openmodelingfoundation.github.io](https://github.com/openmodelingfoundation/openmodelingfoundation.github.io)
- [Awesome Modeling Practices](/resources/awesome-modeling-practices/) (source: [openmodelingfoundation/awesome-modeling-practices](https://github.com/openmodelingfoundation/awesome-modeling-practices))
- [OMF Agent Skills](https://github.com/openmodelingfoundation/skills) **coming soon**
2 changes: 1 addition & 1 deletion content/en/standards/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ cascade:
- type: docs
menu:
main:
weight: 20
weight: 40
---

These pages present current standards in development or adopted by the Open Modeling Foundation. Select a topic to see standards documents relevant to that topic. See the "How to Contribute" pages for details on how to participate in the development of community modeling standards.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
---
title: "Working Groups"
linkTitle: "Working Groups"
cascade:
- type: "docs"
aliases:
- /about/working-groups/
menu:
main:
weight: 30
weight: 100
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: "Certification Working Group"
linkTitle: "Certification"
aliases:
- /about/working-groups/certification/
---
The Certification Working Group (CWG) develops and administers programs to certify model code that meets OMF standards for modeling best practices, and officially recognize model developers who apply these standards. CWG activities include developing and administering a community-wide program for model code peer review, establishing metrics for standards compliance, creating and assigning digital certification badges that follow guidelines being developed by the National Information Standards Organization (NISO). The CWG helps OMF member (and other) code repositories to ensure that models meeting OMF standards are clearly identified and developers who create standards-based models are publicly recognized. The CWG coordinates collaborative efforts with journals, funding agencies, societies, institutions/labs, other software/modeling consortia, and professional bodies to disseminate and administer OMF standards across the community of modeling science, and to promote recognition of OMF standards.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: "Cyberinfrastructure Working Group"
linkTitle: "Cyberinfrastructure"
aliases:
- /about/working-groups/cyberinfrastructure/
---
The Cyberinfrastructure Working Group (CYWG) coordinates development and management of the OMF Science Gateway, an online platform for collaborative governance and standards. CYWG works to to identify, develop, and enhance tools and processes that lower the technical barriers towards adoption of OMF standards and facilitate their use by modeling scientists. CYWG staff assist the EOWG in developing online training modules and making them available on the OMF Science Gateway.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: "Early Career Scholars Working Group"
linkTitle: "Early Career Scholars"
aliases:
- /about/working-groups/early-career-scholars/
---
The Early Career Scholars (ECSWG) helps the Open Modeling Foundation to support student and early career development. The ECSWG is
open to any student enrolled in an institution of higher learning (e.g., college or university) or early career scholar (recent graduate).
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: "Early Career Scholars WG Meeting Minutes"
linkTitle: "Meeting Minutes"
aliases:
- /about/working-groups/early-career-scholars/meeting-minutes/
---

## Dec 10, 2025 8:00 AM GMT+1
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: "Education and Outreach Working Group"
linkTitle: "Education and Outreach"
aliases:
- /about/working-groups/education-and-outreach/
---
The Education and Outreach Working Group (EOWG) helps OMF member organizations reach and train next generation scholars and ensure proactive outreach to groups and nationalities that are underrepresented in modeling science. Depending on available resources, it may develop and deploy educational and training materials, organize workshops, symposia, clinics, and other promotional or engagement events to disseminate OMF standards and help modeling scientists meet those standards. The EOWG coordinates with the SWG to ensure that standards adopted by the OMF are supported by appropriate training and educational programs, and accessible via the OMF Science Gateway. The EOWG coordinates with the OMF Early Career Scholars to develop programs to support early-career scientists. Depending on available resources, such programs may include scholarships to attend trainings in standards-based modeling or presenting standards-based modeling research at professional meetings.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: "Standards Working Group"
linkTitle: "Standards"
aliases:
- /about/working-groups/standards/
---
## **Overview**

Expand Down
Loading
Loading