Skip to content

Consolidate DESCRIPTION.rst and README.md #300

Closed

Description

@leofang

Indeed we're duplicating some of the information. It might take a few iterations to consolidate the two files and have something presentable on both PyPI and GitHub. Let's address this in the next release.

Originally posted by @leofang in #296 (comment)

Activity

  1. added this to the cuda.core beta 3 milestone on Dec 13, 2024
  2. added
    documentationImprovements or additions to documentation
    P1Medium priority - Should do
    cuda.coreEverything related to the cuda.core module
    on Dec 13, 2024
  3. vzhurba01 commented on Jan 15, 2025

    @vzhurba01
    Contributor

    I'd like to extend the scope of this issue to help consolidate/organize all the README.md and DESCRIPTION.rst between cuda-python, cuda.bindings and cuda.core. When resolving issue #297 with PR 397 I found that cuda.bindings also has awkwardness in creating a consolidated file that is presentable on both PyPI and GitHub.

    For PyPI, it seems like we'd want:

    • To direct users to documentation
    • Runtime dependencies
    • Installing? (Perhaps a link to installing page in documentation is better)

    For GitHub:

    • Same as PyPI
    • Development info
    • Running tests, samples and benchmarks

    There's some overlap in dev info across subpackages that may belong better under cuda-python:

    • Code Linting
    • Code Signing
    • Supported Python Versions

    In conclusion, info that applies to all subpackages should be under cuda-python while development info specific to a subpackage should be kept out of PyPI.

  4. leofang commented on Jan 15, 2025

    @leofang
    MemberAuthor

    Sounds like a plan! You have earned the title "trusted assignee," Vlad 👍

  5. leofang commented on Jan 15, 2025

    @leofang
    MemberAuthor

    cc @rwgk for vis

  6. added
    P2Low priority - Nice to have
    and removed
    P1Medium priority - Should do
    on Feb 18, 2025
  7. added
    P1Medium priority - Should do
    and removed
    P2Low priority - Nice to have
    on Feb 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

P1Medium priority - Should docuda.bindingsEverything related to the cuda.bindings modulecuda.coreEverything related to the cuda.core moduledocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions