Skip to content

Conversation

@oscarvalenzuelab
Copy link
Collaborator

Summary

Standardize src2purl README structure to align with other SEMCL.ONE projects, correctly displaying its AGPL-3.0 license (not Apache-2.0 like other projects).

Key Changes

License Badge Correction

  • IMPORTANT: Added correct AGPL-3.0 license badge (this project uses AGPL, not Apache)
  • Badge correctly links to AGPL-3.0 license information
  • License section properly states "GNU Affero General Public License v3.0"

Structure Improvements

  • Added professional badge row (AGPL-3.0 license, Python version, PyPI)
  • Reorganized content following standardized template
  • Simplified complex feature descriptions into concise bullets
  • Added Quick Start section for immediate value
  • Consolidated usage examples

Content Enhancements

  • Added SEMCL.ONE ecosystem integration section
  • Improved project description with clear value proposition
  • Added Configuration section with environment variables
  • Added Contributing, Support, and Authors sections
  • Removed redundant Status section at end

Documentation Links

  • Added links to documentation files (to be created in future PR)
  • Structured for user guide, API reference, discovery methods, and examples

Why This Matters

  1. License Clarity: src2purl uses AGPL-3.0 (copyleft), not Apache-2.0 like most SEMCL.ONE projects
  2. Consistency: Aligns with standardized structure across ecosystem
  3. Professional Appearance: Proper badges and organized layout
  4. Better Navigation: Clear sections and logical flow
  5. PyPI Compatibility: Follows packaging best practices

Test Plan

  • Verify LICENSE file shows AGPL-3.0
  • Check AGPL-3.0 badge displays correctly
  • Ensure badge URL links to correct license
  • Validate markdown formatting
  • Confirm all content preserved or improved

License Note

This project uniquely uses AGPL-3.0 within the SEMCL.ONE ecosystem:

  • Most projects: Apache-2.0 (permissive)
  • src2purl: AGPL-3.0 (copyleft)

The README now correctly reflects this important distinction.

- Add comprehensive badges with correct AGPL-3.0 license (not Apache-2.0)
- Restructure content following standardized template for consistency
- Simplify and consolidate features into high-level bullets
- Add SEMCL.ONE ecosystem integration section
- Improve Quick Start section for immediate user value
- Consolidate Usage section with clear CLI and API examples
- Add Configuration section with environment variables
- Add proper Contributing, Support, and Authors sections
- Link to documentation (to be created) for detailed information
- Remove redundant Status section at end
- Follow PyPI and OSS documentation best practices

This aligns src2purl documentation with other SEMCL.ONE projects
while correctly reflecting its AGPL-3.0 license status.
@oscarvalenzuelab oscarvalenzuelab added bug Something isn't working documentation Improvements or additions to documentation labels Nov 5, 2025
@Psep Psep merged commit ca6f53d into main Nov 5, 2025
7 checks passed
@Psep Psep deleted the feature/standardize-readme-v2 branch November 5, 2025 01:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants