search

hyphacoop / handbook

Member's handbook describing the vision, processes, and culture of Hypha 🌿🍄
https://handbook.hypha.coop
Creative Commons Attribution Share Alike 4.0 International
26 stars 4 forks source link

Fix link to public offboarding checklist #270

Closed patcon closed 5 months ago

patcon commented 7 months ago

Re-ticketed from https://github.com/hyphacoop/organizing/issues/513#issuecomment-1827893853

Link on this page of the handbook doesn't work: https://handbook.hypha.coop/templates/checklist-offboarding.md

Works going directly to the file on github.

FYI:

For more coherence, might be worth linking the templates page to both public and private, but your call.

tripledoublev commented 7 months ago

It's weird that the link you said is broken does work for me. https://handbook.hypha.coop/templates/checklist-offboarding.md

That being said, I do agree that the links to these templates should be modified for improved coherence.

Thanks for pointing it out! I will check-in with the Communications WG to see what is the preferred visibility for these templates.

Current state of template visibility (context for discussion):

We have some templates that are publicly available on the handbook: https://github.com/hyphacoop/handbook/tree/master/templates

On the templates page, some of these link to Google Docs, others link straight to the issue template on GH. Visibility is then dependent on the repository's settings.

On the offboarding page, we link to the md file hosted on the handbook.

For increased coherence and easier maintainability, I would suggest we link everything to github.

If we really want to preserve some visibility into these templates, we could add a link to the publicly visible handbook templates as a way to make private github templates public. This means that issue templates for organizing-private would have both public (on the handbook) and private (on github).

If a template is public on github, I would remove it's duplication on the handbook and only link to GH.

patcon commented 6 months ago

Linking to github's public copy seems like a fine resolution :)

Fwiw, I confirmed on both Chrome and FF (in incognito mode without extensions) that clicking the existing links first 1) requires two clicks to update the browser url to the actual url, and then also 2) still needs a ctrl+R page refresh to load the raw template page content, even after url bar has updated in (1) 🤷