Skip to content

Commit 684775a

Browse files
jouvinMichel Jouvin
andauthored
Web how-to improvements (#1623)
- running-meetings page linked from howto-website page - howto-website: reference to the HSF site made relative to site.base_url rather than absolute (required to test site properly on a different machine) Co-authored-by: Michel Jouvin <[email protected]>
1 parent 94f9c4a commit 684775a

File tree

2 files changed

+7
-8
lines changed

2 files changed

+7
-8
lines changed

howto-website.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -57,9 +57,7 @@ we have [documentation]({{ site.baseurl }}/jekyll-beginners.html) on how to do i
5757

5858
### Adding coordination meeting minutes
5959

60-
HSF Coordination minutes are produced using the live notes approach described above. The content of the live notes are preformatted to be suitable for direct injection into Jekyll. The minutes file must be placed into Jekyll `organization/_posts` directory.
61-
62-
The only edit required is the replacement of the *front-matter* section by the one present in the previous meeting minutes in Jekyll, updating the title (meeting number and date).
60+
HSF Coordination minutes are produced using the live notes approach described above. The content of the live notes are preformatted to be suitable for direct injection into Jekyll, after minimal edits described in the [running-meetings]({{ site.baseurl }}/organization/running-meetings.html) page. The minutes file must be placed into Jekyll `organization/_posts` directory.
6361

6462
### Adding a working group or activity
6563

organization/running-meetings.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,16 +13,17 @@ Then, here is a short checklist for running the meeting:
1313

1414
1. **Announce the meeting**: Indico should be setup to send reminders about the meetings 2 days and 2 hours in advance. These go to HSF Steering Group and Activity Area conveners, so you don't usually need to do this manually.
1515
- However, if specific input is needed you might want to send a targeted email a suitable time in advance.
16-
2. **Prepare the minutes**: The meeting is minuted in the [live notes](https://hepsoftwarefoundation.org/howto-website.html) document. A few days before the meeting (usually on Monday when the weekly meetings email is sent) clean up this document.
17-
1. Check that the previous meeting's minutes were published on the [website](https://hepsoftwarefoundation.org/organization/minutes.html). If not, see if there is a [pull request](https://github.com/HSF/hsf.github.io/pulls) and remind people to edit/accept that.
16+
2. **Prepare the minutes**: The meeting is minuted in the [live notes]({{ site.baseurl }}/howto-website.html) document. A few days before the meeting (usually on Monday when the weekly meetings email is sent) clean up this document.
17+
1. Check that the previous meeting's minutes were published on the [website]({{ site.baseurl }}/organization/minutes.html). If not, see if there is a [pull request](https://github.com/HSF/hsf.github.io/pulls) and remind people to edit/accept that.
1818
- In the rare case where the minutes from the previous meeting have not been handled, please save a copy of the previous minutes before you start the clean up.
1919
2. Clean up the different sections from the last meeting (there are a few "standing items" as reminders that get left from meeting to meeting).
2020
3. Pre-populate the minutes with news and any other items of Activity Area information or AOB that you are aware of.
2121
3. **Chair the meeting**: Generally this is going through the list of news items, working group reports and AOBs. Ensure you call for comments/questions. Usually people know to pre-populate the minutes, but discussion points and comments need to be recorded. Encourage people to write these directly, but take them yourself if necessary.
2222
- To take proper attendance (not everyone remembers to write their name), it's a good idea to just screenshot the Zoom participants window.
23-
4. **Make a PR with the minutes**: Following the usual procedures for adding content to the HSF website (documented [here](https://hepsoftwarefoundation.org/howto-website.html)), make a GitHub PR to the [HSF website repository](https://github.com/HSF/hsf.github.io).
24-
- Note that all of the [previous minutes](https://github.com/HSF/hsf.github.io/tree/main/organization/_posts) are nice templates for the small number of changes between CodiMD and the GitHub Markdown for the website.
25-
- **In particular, we don't publish standing reminders or *NTR* sections, just delete these.**
23+
4. **Make a PR with the minutes**: Following the usual procedures for adding content to the HSF website (documented [here]({{ site.baseurl }}/howto-website.html)), make a GitHub PR to the [HSF website repository](https://github.com/HSF/hsf.github.io).
24+
- Note that all of the [previous minutes](https://github.com/HSF/hsf.github.io/tree/main/organization/_posts) are nice templates for the small number of changes between CodiMD and the GitHub Markdown for the website. In particular:
25+
- **The *front-matter* section must be replaced by the one present in the previous meeting minutes in Jekyll, updating the title (meeting number and date).**
26+
- **We don't publish standing reminders or *NTR* sections, just delete these.**
2627
- Ask one of the other participants to review the PR - it avoids a lot of mistakes, typos and omissions when someone else takes a look.
2728
- If you don't have permission to do any of those steps, ask on the <[email protected]> list (send your GitHub ID) and someone will set this up for you.
2829

0 commit comments

Comments
 (0)