Skip to content

doc: move dev instructions to a new dev guide #2783

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

Merged
merged 13 commits into from
May 25, 2022
Merged

Conversation

hengm3467
Copy link
Contributor

@hengm3467 hengm3467 commented May 24, 2022

What's changed and what's your intention?

In the existing CONTRIBUTING.md, the instructions about submitting PRs are mixed with the instructions about how to develop RisingWave, which, due to its size, warrants a separate document, hence this pull request. The instructions about how to test the code changes are also moved to the developer guide.

@skyzh Please review and let me know if you have any comments. Thanks!

Additional changes are needed on top of the draft PR submitted by Ting. @Sunt-ing : Please review the changes and make necessary adjustments. Thanks.

PLEASE DO NOT LEAVE THIS EMPTY !!!

Please explain IN DETAIL what the changes are in this PR and why they are needed:

  • Summarize your change (mandatory)
  • How does this PR work? Need a brief introduction for the changed logic (optional)
  • Describe clearly one logical change and avoid lazy messages (optional)
  • Describe any limitations of the current code (optional)
  • Add the 'user-facing changes' label if your PR contains changes that are visible to users (optional)

Checklist

  • I have written necessary docs and comments
  • I have added necessary unit tests and integration tests

Refer to a related PR or issue link (optional)

#2198

@hengm3467 hengm3467 requested a review from skyzh May 24, 2022 11:36
@github-actions github-actions bot added the A-doc Area: Documentation. label May 24, 2022
@codecov
Copy link

codecov bot commented May 24, 2022

Codecov Report

Merging #2783 (2c215ed) into main (bd7739d) will increase coverage by 0.06%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             main    #2783      +/-   ##
==========================================
+ Coverage   72.57%   72.63%   +0.06%     
==========================================
  Files         701      701              
  Lines       91382    91496     +114     
==========================================
+ Hits        66321    66461     +140     
+ Misses      25061    25035      -26     
Flag Coverage Δ
rust 72.63% <ø> (+0.06%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files Coverage Δ
src/expr/src/expr/expr_field.rs 94.05% <0.00%> (-1.07%) ⬇️
src/meta/src/barrier/mod.rs 65.49% <0.00%> (-0.32%) ⬇️
src/expr/src/expr/test_utils.rs 100.00% <0.00%> (ø)
src/batch/src/rpc/service/task_service.rs 0.00% <0.00%> (ø)
src/common/src/types/ordered_float.rs 24.90% <0.00%> (+0.19%) ⬆️
src/stream/src/executor/managed_state/join/mod.rs 73.56% <0.00%> (+0.46%) ⬆️
src/batch/src/task/task_manager.rs 82.12% <0.00%> (+1.95%) ⬆️
src/batch/src/task/task_.rs 52.09% <0.00%> (+13.97%) ⬆️
src/batch/src/executor2/generate_series.rs 79.28% <0.00%> (+21.42%) ⬆️
src/batch/src/executor2/trace.rs 42.85% <0.00%> (+21.42%) ⬆️
... and 2 more

📣 Codecov can now indicate which changes are the most critical in Pull Requests. Learn more

@Sunt-ing
Copy link
Contributor

IMO you may directly delete the content you moved from Contributing.md. I mean, this PR can integrate my PR (#2200). And after this PR is merged, I will close my PR.

Add cross-references and connecting descriptions to both docs to ensure a smooth information navigation experience.
Copy link
Contributor

@Sunt-ing Sunt-ing left a comment

Choose a reason for hiding this comment

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

LGTM!

Copy link
Contributor

@skyzh skyzh left a comment

Choose a reason for hiding this comment

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

RiseDev currently also supports Kafka + Zookeeper. May modify this docs to reflect the change.

Rest LGTM, good work!

@hengm3467
Copy link
Contributor Author

RiseDev currently also supports Kafka + Zookeeper. May modify this docs to reflect the change.

Added descriptions of Kafka and ZooKeeper components/services.

@hengm3467 hengm3467 requested a review from skyzh May 25, 2022 06:24
@hengm3467
Copy link
Contributor Author

@skyzh All comments resolved. Please check and let me know if you have additional comments. Thanks!

@hengm3467 hengm3467 merged commit ad6db49 into main May 25, 2022
@hengm3467 hengm3467 deleted the heng-updates-may24 branch May 25, 2022 07:07
Enter-tainer pushed a commit that referenced this pull request May 26, 2022
* doc: move dev instructions to a new dev guide

* doc: remove dev instructions from contributing.md

Add cross-references and connecting descriptions to both docs to ensure a smooth information navigation experience.

* doc: update cross-reference links

* doc: fix a typo

* Update developer-guide.md

* Update CONTRIBUTING.md

* doc: clarify about enabling and downloading a component

* doc: bug fixes and additional info

* doc: fix file names and links

Co-authored-by: Ting Sun <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-doc Area: Documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants