diff --git a/.gitignore b/.gitignore index 866173dc..cc21f9dd 100644 --- a/.gitignore +++ b/.gitignore @@ -8,6 +8,9 @@ node_modules/ .docusaurus .cache-loader +# Populated at build time +/community/minutes/*.md + # Misc .DS_Store .env.local diff --git a/bin/populate-minutes b/bin/populate-minutes new file mode 100755 index 00000000..38741fc2 --- /dev/null +++ b/bin/populate-minutes @@ -0,0 +1,29 @@ +#!/usr/bin/env bash +set -euo pipefail + +HERE=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd ) + +rm ${HERE}/../community/minutes/*.md +pushd $(mktemp -d) +curl -L https://github.com/conda-incubator/governance/archive/refs/heads/main.tar.gz -o governance.tar.gz +tar -C "${HERE}/../community/minutes" -xf governance.tar.gz --strip-components 3 "governance-main/meetings/archive/" +popd + +pushd ${HERE}/../community/minutes +for f in *.md; do + # Rename files from YYYYMMDD_agenda_and_minutes.md to YYYY-MM-DD.md + mv "$f" "${f:0:4}-${f:4:2}-${f:6:2}.md" +done + +# Fix some markdown issues +for f in 2020-08-24.md 2020-09-08.md 2020-09-22.md; do + sed -i.bak 's/]()/](#)/g' "$f" + rm "$f.bak" +done +sed -i.bak \ + -e 's|](conda.org)|](https://conda.org)|g' \ + -e 's|](github.org)|](https://github.org)|g' \ + "2020-09-08.md" +rm 2020-09-08.md.bak + +popd diff --git a/community/minutes/README b/community/minutes/README new file mode 100644 index 00000000..5da075bd --- /dev/null +++ b/community/minutes/README @@ -0,0 +1,2 @@ +This directory is populated at build time by downloading all the minutes +from conda-incubator/governance. See `/bin/populate-minutes`. Do not edit manually. \ No newline at end of file diff --git a/community/minutes/index.mdx b/community/minutes/index.mdx new file mode 100644 index 00000000..7ef1d842 --- /dev/null +++ b/community/minutes/index.mdx @@ -0,0 +1,26 @@ +# Meeting minutes + +We hold biweekly meetings every second Wednesday from 17:00-18:00 (UTC). Feel free to stop by! +Up-to-date invites are always available in the [calendar](/community/calendar). + +We encourage contributors to join the meetings and learn more about and from the community. + +## Setup + +The minutes are recorded in the [`conda-incubator/governance`][governance-repo] repository. + +We use a Github Actions [workflow][gha-workflow] to create an automated PR with the meeting notes +template for each session, which is automatically published to our [HackMD team][hackmd-team] +account. During the meeting, attendees will edit the HackMD document. After the meeting, the +document is saved and the PR is synced with the changes by adding the `sync-hackmd-notes` label. +Once satisfied, the PR is merged and the website will be updated with the new meeting notes. + +[gha-workflow]: https://github.com/conda-incubator/governance/actions/workflows/meeting-notes.yml +[hackmd-team]: https://hackmd.io/@conda-community +[governance-repo]: https://github.com/conda-incubator/governance + +## Minutes + +import DocCardList from '@theme/DocCardList'; + + \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index 151e0501..19b49117 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -35,6 +35,10 @@ const config = { }, ], + markdown: { + format: "detect", + }, + presets: [ [ "classic", diff --git a/package.json b/package.json index c346590a..feab09c9 100644 --- a/package.json +++ b/package.json @@ -4,8 +4,8 @@ "private": true, "scripts": { "docusaurus": "docusaurus", - "start": "docusaurus start", - "build": "docusaurus build", + "start": "./bin/populate-minutes && docusaurus start", + "build": "./bin/populate-minutes && docusaurus build", "swizzle": "docusaurus swizzle", "deploy": "docusaurus deploy", "clear": "docusaurus clear",