Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Developer Guides, replace internal.md, CONTRIBUTING.md #625

Merged
merged 23 commits into from
Sep 8, 2022

Conversation

isVoid
Copy link
Contributor

@isVoid isVoid commented Aug 3, 2022

This PR introduces 3 documents for developer guides. The overall goal for these docs is to provide a place to centralize best practices and provide guidance to developers of all levels to bootstrap development for cuspatial.

This PR deprecates internals.md. The design of geocolumn has improved dramatically since #585 , rendering many of the description obsolete. Further, examples of geoarrow and detail description of geoarrow should be hosted in geoarrow specification. library_design.md replaces internal.md.

CONTRIBUTING.md is deprecated and only leaves a pointer to contributing_guide.md. The contents are highly identical to the overall RAPIDS contribution guide: https://docs.rapids.ai/contributing. This link is included in the contributing guide and is thus removed to maintain a single source of truth.

@github-actions github-actions bot added the conda Related to conda and conda configuration label Aug 3, 2022
@github-actions github-actions bot removed the conda Related to conda and conda configuration label Aug 3, 2022
@trxcllnt
Copy link
Contributor

@isVoid did you want help adding to this doc?

@isVoid
Copy link
Contributor Author

isVoid commented Aug 16, 2022

That would be awesome. Let's chat about this soon.

@harrism harrism added this to the Developer Documentation milestone Aug 24, 2022
@harrism harrism added doc Documentation non-breaking Non-breaking change Python Related to Python code labels Aug 24, 2022
@github-actions github-actions bot removed the Python Related to Python code label Aug 24, 2022
@isVoid isVoid mentioned this pull request Aug 24, 2022
@isVoid isVoid changed the title Add Library Design Add Developer Guides Aug 24, 2022
@isVoid isVoid marked this pull request as ready for review August 24, 2022 21:22
@isVoid isVoid changed the title Add Developer Guides Add Developer Guides, replace internal.md, CONTRIBUTING.md Aug 24, 2022
Copy link
Member

@harrism harrism left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for doing this. I made lots of edits -- mostly for grammar / readability and typos, but also for line length. There are also a few questions mixed in with the edit suggestions.

docs/source/developer_guide/contributing_guide.md Outdated Show resolved Hide resolved
docs/source/developer_guide/contributing_guide.md Outdated Show resolved Hide resolved
docs/source/developer_guide/contributing_guide.md Outdated Show resolved Hide resolved
docs/source/developer_guide/contributing_guide.md Outdated Show resolved Hide resolved
docs/source/developer_guide/contributing_guide.md Outdated Show resolved Hide resolved
docs/source/developer_guide/library_design.md Outdated Show resolved Hide resolved
docs/source/developer_guide/library_design.md Outdated Show resolved Hide resolved
docs/source/developer_guide/library_design.md Outdated Show resolved Hide resolved
docs/source/developer_guide/library_design.md Outdated Show resolved Hide resolved
docs/source/developer_guide/library_design.md Outdated Show resolved Hide resolved
Comment on lines +125 to +126
Therefore the wrapper should not contain additional components besides
the above.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Therefore the wrapper should not contain additional components besides
the above.
Therefore, the wrapper should avoid further data processing and be as
simple as possible.

Copy link
Contributor

@thomcom thomcom left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The only change I saw worth noting is that you appear to go back and forth
in your line length selection. For the user docs I am setting all of the lines to
(provisionally) 96 chars wide, and using the double space as a CRLF
delimiter to instruct markdown to always start a new line where I suggest.

It's my opinion that this improves readability by giving a limited column width
in HTML, and giving a consistent column width when reading in .md.

@thomcom
Copy link
Contributor

thomcom commented Sep 8, 2022

rerun tests

@thomcom
Copy link
Contributor

thomcom commented Sep 8, 2022

@gpucibot merge

@rapids-bot rapids-bot bot merged commit e93118a into rapidsai:branch-22.10 Sep 8, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Documentation non-breaking Non-breaking change
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

4 participants