Skip to content

chore: add dokka plugin for documentation generation and versioning #104

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
wants to merge 2 commits into
base: feature/new-sdk-core
Choose a base branch
from

Conversation

OmarAlJarrah
Copy link
Contributor

@OmarAlJarrah OmarAlJarrah commented Apr 9, 2025

Situation

The current build configuration for the XAP SDK does not include documentation generation capabilities, which limits the accessibility and usability of the SDK for developers.

Task

The objective is to integrate the Dokka documentation tool into the build process of the XAP SDK.

Action

  1. Added the org.jetbrains.dokka plugin to the build.gradle.kts file.
  2. Configured Dokka to generate HTML documentation with custom assets and styles.
  3. Implemented versioning for the documentation to manage and display different versions effectively.
  4. Updated the gradle.properties file to enable experimental Dokka plugin mode.

Testing

The changes were validated by running the build process and verifying that the documentation was generated successfully. The documentation was checked for correctness, inclusion of custom assets, and proper versioning. The build process was also tested to ensure that it completes without errors.

Results

The integration of Dokka into the build process has successfully enabled automated documentation generation for the XAP SDK. This improvement provides developers with easily accessible and versioned documentation, enhancing their ability to use the SDK. The build process remains stable with the new changes.

Notes

@OmarAlJarrah OmarAlJarrah requested a review from a team as a code owner April 9, 2025 12:04
@OmarAlJarrah OmarAlJarrah changed the base branch from main to feature/new-sdk-core April 9, 2025 12:05
@mohnoor94 mohnoor94 assigned mohnoor94, dtayeh and anssari1 and unassigned dtayeh and mohnoor94 Apr 17, 2025
@OmarAlJarrah OmarAlJarrah changed the base branch from feature/new-sdk-core to v2/initial-github-actions April 21, 2025 06:54
@OmarAlJarrah OmarAlJarrah changed the base branch from v2/initial-github-actions to feature/new-sdk-core April 21, 2025 06:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants