Skip to content

Add Software Publishing concept topic - #501

Merged
Jolien-S merged 6 commits into
mainfrom
topic/software-publishing
Aug 6, 2025
Merged

Add Software Publishing concept topic#501
Jolien-S merged 6 commits into
mainfrom
topic/software-publishing

Conversation

@chartgerink

Copy link
Copy Markdown
Collaborator

Summary

This PR adds a comprehensive concept topic for Software Publishing, covering the process of making research software publicly available through formal publication channels.

Content Overview

The new concept topic covers:

  • Definition: Software publishing vs. simple code sharing, formal publication channels
  • Publication types: Standalone software papers, repository deposits, package registries
  • VU resources: Pure registration, Zenodo integration, JOSS support, quality assurance
  • Requirements: Documentation, peer review, quality assurance, and metadata standards
  • Research benefits: Academic recognition, citation impact, career advancement, and scientific contribution

Key Features

  • Follows established handbook template structure for concepts
  • Comprehensive coverage of software publication ecosystem and processes
  • Integration with VU institutional requirements and support systems
  • Cross-references to software registration and archiving workflows
  • Practical guidance on preparing software for formal publication

Review Notes

  • Content developed from academic publishing practices adapted for research software
  • VU resources aligned with current software registration policies and publishing platforms
  • References to established software journals and publication venues
  • Integration with broader academic recognition and career development frameworks

⚠️ AI-Generated Content Notice: This content was drafted by Claude LLM on July 21st, 2025, as part of a trial to explore AI-assisted content creation for the handbook. This content requires thorough review and revision before publication. This trial does not indicate that all future content will be AI-generated - this is an experiment that may not prove effective enough to justify continued use.

Related to #354

- Comprehensive coverage of formal research software publication
- Details publication platforms, peer review, and academic recognition
- Covers VU publishing resources and quality assurance processes
- Includes career development and research impact considerations

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@chartgerink
chartgerink requested a review from a team as a code owner July 21, 2025 12:50
@github-actions

Copy link
Copy Markdown
Contributor

Summary

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

@netlify

netlify Bot commented Jul 21, 2025

Copy link
Copy Markdown

Deploy Preview for ubvu-open-handbook ready!

Name Link
🔨 Latest commit a9e9814
🔍 Latest deploy log https://app.netlify.com/projects/ubvu-open-handbook/deploys/68835e224a20310008d5c631
😎 Deploy Preview https://deploy-preview-501--ubvu-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: 13
Accessibility: 81
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.

@Jolien-S

Copy link
Copy Markdown
Collaborator

I had something in mind along the lines of the Data publishing topic. I think it would be nice to apply the same structure, and perhaps also copy the definition (but add an explanation about what this means in practice for research software). I think there is some good information in this PR that we can use, but I don't think we need all of it. I'm curious what you think @charliegreene9.

Overhaul of AI article to replicate data publishing article with inspiration from the software archiving article
@netlify

netlify Bot commented Jul 25, 2025

Copy link
Copy Markdown

Deploy Preview for ub-open-handbook ready!

Name Link
🔨 Latest commit fc9c28c
🔍 Latest deploy log https://app.netlify.com/projects/ub-open-handbook/deploys/689315d1ac32d70007270520
😎 Deploy Preview https://deploy-preview-501--ub-open-handbook.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.

@github-actions

Copy link
Copy Markdown
Contributor

Summary

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

Comment thread topics/software-publishing.qmd Outdated
Comment thread topics/software-publishing.qmd Outdated
Comment thread topics/software-publishing.qmd Outdated
I replaced URLs to tools with references to Handbook pages.
@github-actions

github-actions Bot commented Aug 6, 2025

Copy link
Copy Markdown
Contributor

Summary

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

Comment thread topics/software-publishing.qmd Outdated
I changed the information about software publishing in practice a bit, distinguishing between repositories where you get a persistent identifier on the one hand and software developing platforms on the other. I also elaborated a bit more about OSF.
@github-actions

github-actions Bot commented Aug 6, 2025

Copy link
Copy Markdown
Contributor

Summary

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

I changed the bullet lists.
@github-actions

github-actions Bot commented Aug 6, 2025

Copy link
Copy Markdown
Contributor

Summary

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

Comment thread topics/software-publishing.qmd Outdated
@github-actions

github-actions Bot commented Aug 6, 2025

Copy link
Copy Markdown
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 merged commit bc96ad9 into main Aug 6, 2025
9 checks passed
@Jolien-S
Jolien-S deleted the topic/software-publishing branch August 6, 2025 09:07
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