axone-protocol / docs

📜 Axone documentation portal (built with Docusaurus).
https://docs.axone.xyz/
BSD 3-Clause "New" or "Revised" License
40 stars 22 forks source link

feat(academy): add part1.1 #368

Closed MathieuConte closed 9 months ago

MathieuConte commented 9 months ago

Minor change :

I've just removed the image "SUM UP" We might design it before adding to the page. sum up

You can review it 👍

Summary by CodeRabbit

coderabbitai[bot] commented 9 months ago

Walkthrough

The documentation has been expanded with new educational content, focusing on core concepts of a protocol and distinguishing between types of digital resources and services. It underscores the importance of these elements in the context of the OKP4 protocol's resource management and interoperability features.

Changes

File Path Change Summary
.../protocol-concepts.md Added a section on "Protocol concepts."
.../resources.md Overhauled to introduce Digital Resources, Digital Services, Verifiable Claims, and Ontology in the OKP4 protocol.

🐇✨ In the doc's garden, fresh knowledge blooms Digital seeds in their conceptual rooms Bounded by bytes, unbounded by claims Services dance, and Ontology reigns 🌟 📚🐰

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share - [X](https://twitter.com/intent/tweet?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A&url=https%3A//coderabbit.ai) - [Mastodon](https://mastodon.social/share?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A%20https%3A%2F%2Fcoderabbit.ai) - [Reddit](https://www.reddit.com/submit?title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&text=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code.%20Check%20it%20out%3A%20https%3A//coderabbit.ai) - [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fcoderabbit.ai&mini=true&title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&summary=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code)

Tips ### Chat There are 3 ways to chat with CodeRabbit's AI: - Review comments: Directly reply to a review comment made by CodeRabbit. Example: - `I pushed a fix in commit .` - `Generate unit-tests for this file.` - Files and specific lines of code (under the "Files changed" tab): Tag `@coderabbitai` in a new review comment at the desired location with your query. Examples: - `@coderabbitai generate unit tests for this file.` - `@coderabbitai modularize this function.` - PR comments: Tag `@coderabbitai` in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples: - `@coderabbitai generate interesting stats about this repository from git and render them as a table.` - `@coderabbitai show all the console.log statements in this repository.` - `@coderabbitai read src/utils.ts and generate unit tests.` - `@coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid.` - `@coderabbitai read the files in the src/scheduler package and generate README in the markdown format.` Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. ### CodeRabbit Commands (invoked as PR comments) - `@coderabbitai pause` to pause the reviews on a PR. - `@coderabbitai resume` to resume the paused reviews. - `@coderabbitai review` to trigger a review. This is useful when automatic reviews are disabled for the repository. - `@coderabbitai resolve` resolve all the CodeRabbit review comments. - `@coderabbitai help` to get help. Additionally, you can add `@coderabbitai ignore` anywhere in the PR description to prevent this PR from being reviewed. ### CodeRabbit Configration File (`.coderabbit.yaml`) - You can programmatically configure CodeRabbit by adding a `.coderabbit.yaml` file to the root of your repository. - The JSON schema for the configuration file is available [here](https://coderabbit.ai/integrations/coderabbit-overrides.v2.json). - If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: `# yaml-language-server: $schema=https://coderabbit.ai/integrations/coderabbit-overrides.v2.json` ### CodeRabbit Discord Community Join our [Discord Community](https://discord.com/invite/GsXnASn26c) to get help, request features, and share feedback.
ccamel commented 9 months ago

@MathieuConte I have slightly adjusted the hierarchy of the titles to align with the expectations set by Docusaurus. We should now be ok.

image
MdechampG commented 9 months ago

Thanks @MathieuConte ! I changed the content from the page "Protocol-concepts"which is the part 1.4 to the page "Resources" which is the 1.1 Thus, I readjusted the hierarchy of the titles.

Could you change the name of the illustrations (protocol-concept -> resources) please ?

As for the illustration, could you create a dedicated issue ?

MathieuConte commented 9 months ago

Ok I've modified the name of illustrations and I'll create a issue for the new illustration

MdechampG commented 9 months ago

Thanks @MathieuConte you can merge 🚀