Skip to content

Conversation

@jhrudey
Copy link
Collaborator

@jhrudey jhrudey commented Nov 27, 2025

Just the initial page, not at all ready for publication yet!

Pull Request Checklist

General Writing Standards

Voice and Clarity

  • Text is primarily written in active voice
  • Acronyms are written in full at least once on the page where they are used
  • We refer to Handbook topics where possible (e.g. to the Handbook page about Yoda instead of some other information page about Yoda)

Links and Referencing

  • All links use https:// protocol
  • Links are descriptive (avoid "click here" links)
  • For pages with a DOI, link through the DOI (e.g., https://doi.org/10.4444/xxxx)

Images

  • All images have descriptive alt text

Tone and Style

  • Avoid writing in the name of the handbook (no "we recommend")

Topic-Specific Standards

  • Topics are nouns or noun phrases
  • Topics are self-contained and concise
  • Topics are title capitalized
  • No include statements in topics
  • Only use regular markdown (no special Quarto code)
  • Where relevant, assign a suitable category

Guide-Specific Standards

  • Guides are phrased as questions the reader will find answers to
  • Where relevant, guides are assigned a suitable category

Checklist Usage

  • Fill out this checklist when submitting a pull request
  • Automated checks will verify some of these standards, but manual review is still crucial

Note to Contributors: Thank you for helping maintain the quality of our handbook!

Just the initial page, not at all ready for publication yet!
@jhrudey jhrudey requested a review from a team as a code owner November 27, 2025 10:19
@netlify
Copy link

netlify bot commented Nov 27, 2025

Deploy Preview for ub-open-handbook failed.

Name Link
🔨 Latest commit a6a0ad3
🔍 Latest deploy log https://app.netlify.com/projects/ub-open-handbook/deploys/69283848dd68250008c67ab5

@github-actions
Copy link
Contributor

Summary

Status Count
🔍 Total 0
✅ Successful 0
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 0
❓ Unknown 0
🚫 Errors 0
Full Github Actions output

Based on Emily's previous work in hackathon 1 2025, as well as aspects of my FGB guide and the Groningen guide
@github-actions
Copy link
Contributor

Summary

Status Count
🔍 Total 6
✅ Successful 6
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 0
❓ Unknown 0
🚫 Errors 0
Full Github Actions output

@Jolien-S Jolien-S marked this pull request as draft December 11, 2025 10:34
@Jolien-S Jolien-S marked this pull request as ready for review December 11, 2025 10:34
- I updated internal links (replaced .html with .qmd) and external links (removed target=blank, as this is already taken care of in our style sheet)
- I added references to the UU Data Privacy Handbook and an acknowledgement to UU and FGB)
- I changed to British spelling
@netlify
Copy link

netlify bot commented Jan 8, 2026

Deploy Preview for ub-open-handbook ready!

Name Link
🔨 Latest commit c289dcd
🔍 Latest deploy log https://app.netlify.com/projects/ub-open-handbook/deploys/695fc85155e69800089d28a9
😎 Deploy Preview https://deploy-preview-620--ub-open-handbook.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 15
Accessibility: 90
Best Practices: 100
SEO: 90
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 8, 2026

Summary

Status Count
🔍 Total 7
✅ Successful 7
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 0
❓ Unknown 0
🚫 Errors 0
Full Github Actions output

@Jolien-S
Copy link
Collaborator

Jolien-S commented Jan 9, 2026

I'm discussing this with Jessica and Emily, please do not merge yet.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants