Skip to content

Conversation

@adarsh-priydarshi-5646
Copy link

Description of Changes

This PR improves the readability and formatting of the "How to Contribute" section in DISCOVER/14_how_to_contribute.md.

Changes Made:

  • Updated heading to # How to Contribute for clarity.
  • Broke long sentences into shorter lines for better readability.
  • Removed an unnecessary extra dash in the bullet list.
  • Standardized the feedback section to match other bullets.

Related Issue

Closes #399

Type of Change

  • ✨ Content Enhancement—Updates or improves existing content

Additional Notes (Optional)

Tested locally by building the book and viewing the updated section in the browser.
No functional changes, only documentation improvements.

Checklist

@netlify
Copy link

netlify bot commented Sep 13, 2025

Deploy Preview for stupendous-kringle-a86e81 ready!

Name Link
🔨 Latest commit 8ade124
🔍 Latest deploy log https://app.netlify.com/projects/stupendous-kringle-a86e81/deploys/68e01a1ea27723000878bf15
😎 Deploy Preview https://deploy-preview-400--stupendous-kringle-a86e81.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@adarsh-priydarshi-5646
Copy link
Author

Hi maintainers,

I’ve updated the "How to Contribute" section to improve formatting and readability.
This PR refactors headings and bullet points and removes minor inconsistencies.

Closes #399

I’d appreciate it if you could review this PR when convenient. Thank you! 🙏

- Fix toctree reference error: Changed '15_OA_Protocols.md' to '15_QA_Protocols' in _toc.yml
- Fix heading hierarchy in 15_QA_Protocols.md: Changed H2 to H1 for main title and adjusted subheadings
- Minor formatting improvements in 14_how_to_contribute.md

Resolves Sphinx build warnings:
- 'toctree contains reference to nonexisting document'
- 'document isn't included in any toctree'
- 'Document headings start at H2, not H1'

Build now succeeds with no warnings.
Fixes numfocus#242

- Improved clarity of confusing sentence about speaker recruitment
- Changed 'If your system is to have speakers come to you & ask, but research shows they tend not to do so, they won't come.'
- To: 'If you rely on speakers to approach you directly, research shows that many qualified speakers (especially from underrepresented groups) are unlikely to self-nominate, so you'll miss out on diverse talent.'
- Makes the meaning clearer and explains the diversity impact
@github-actions
Copy link

github-actions bot commented Nov 3, 2025

This pull request has been inactive for 30 days. It will be closed in 14 days if no further activity occurs.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Enhancement]: Documentation / Content formatting improvement

1 participant