Skip to content

Improve EntityView docs #233

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

Open
Indra-db opened this issue Feb 19, 2025 · 3 comments
Open

Improve EntityView docs #233

Indra-db opened this issue Feb 19, 2025 · 3 comments
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers

Comments

@Indra-db
Copy link
Owner

Indra-db commented Feb 19, 2025

Bounty: Improve Documentation Clarity

Objective:
Enhance the project documentation of EntityView so that new users can easily understand and use the API without needing additional external references.


Tasks:

  • Improve Clarity:

    • Rewrite documentation to clearly explain the purpose and usage of each public function on EntityView.
    • Define technical terms and usage patterns as needed.
    • Use concise, unambiguous language to ensure clarity for newcomers.
  • Add Examples:

    • Provide clear, practical examples for every public function missing one.
    • Use examples and test cases from EntityView as models, inspiration.
  • Remove C++ API References:

    • Eliminate all references to the C++ API to avoid confusion for users expecting a Rust-centric documentation.
  • Ensure Doc Tests Pass:

    • Update and verify that all documentation tests (doc tests) run successfully after changes.
  • Reference Implementation:

    • For guidance on the expected quality and style, review commit 52b5fa8 (please open the diff to inspect the work).
Image

Acceptance Criteria:

  • The documentation is clear, concise, and easily understandable by new users.
  • Every public function includes at least one illustrative example.
  • All references to the C++ API have been removed.
  • All documentation tests pass without errors.

End Condition:
When all tasks have been completed and verified according to the acceptance criteria, the bounty will be considered complete. This won't be overly strict, I just expect good quality ;)

@Indra-db Indra-db added documentation Improvements or additions to documentation good first issue Good for newcomers labels Feb 19, 2025
@Indra-db
Copy link
Owner Author

@addbounty $50

@addbounty
Copy link

addbounty commented Feb 19, 2025

banner
button

Make a Draft PR early so others can see you are working on it! To automatically create one:

# Using npx (installed if you have NodeJS/npm)
npx bountybot solve Indra-db/Flecs-Rust#233

Join Our Discord to connect with other bounty hunters and get help.

When merged, you will receive the bounty!

@Indra-db Indra-db changed the title Improve EntityView + World docs Improve EntityView docs Feb 24, 2025
Lowsecs added a commit to Lowsecs/Flecs-Rust that referenced this issue Apr 18, 2025
Lowsecs added a commit to Lowsecs/Flecs-Rust that referenced this issue Apr 24, 2025
@Lowsecs
Copy link

Lowsecs commented Apr 24, 2025

I have a proposal for review: #247

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

3 participants