Skip to content

Update the documentation to API format, describing only the public methods.#57

Merged
Joao-Paulo-Silva merged 60 commits intoAIS-Package:developfrom
Joao-Paulo-Silva:refactor/docs
Apr 21, 2026
Merged

Update the documentation to API format, describing only the public methods.#57
Joao-Paulo-Silva merged 60 commits intoAIS-Package:developfrom
Joao-Paulo-Silva:refactor/docs

Conversation

@Joao-Paulo-Silva
Copy link
Copy Markdown
Member

@Joao-Paulo-Silva Joao-Paulo-Silva commented Mar 3, 2026

Description

This pull request updates the documentation across the AISP package to follow a standardized API format, focusing on describing only public methods and improving consistency with best practices.

Changes

  • Reorganized docstring sections (moved Returns and Raises sections for consistency)
  • Improved clarity and conciseness of parameter descriptions
  • Added template-docs-class.md: Template for documenting classes with public methods
  • Added template-docs-functions.md: Template for documenting module functions
  • Added template-docs-module.md: Template for documenting modules
  • Removed outdated files.

Checklist

  • My code follows the Project Standards.
  • Alls new and existing test passed.
  • I have added docstrings to all new or modified functions and class.

@Joao-Paulo-Silva Joao-Paulo-Silva self-assigned this Mar 15, 2026
@Joao-Paulo-Silva Joao-Paulo-Silva added documentation Improvements or additions to documentation refactor Change without altering behavior. labels Mar 15, 2026
@Joao-Paulo-Silva Joao-Paulo-Silva changed the base branch from main to develop March 30, 2026 19:28
@Joao-Paulo-Silva Joao-Paulo-Silva merged commit 141f0d8 into AIS-Package:develop Apr 21, 2026
4 checks passed
@Joao-Paulo-Silva Joao-Paulo-Silva deleted the refactor/docs branch April 21, 2026 18:00
@Joao-Paulo-Silva Joao-Paulo-Silva mentioned this pull request Apr 21, 2026
Joao-Paulo-Silva added a commit that referenced this pull request Apr 21, 2026
This release (v0.5.4) brings together critical improvements, bug fixes, and documentation updates, with a focus on compatibility, consistency, and API quality.

## Changes

- Improved compatibility with scikit-learn (#60)
    - Added explicit p parameter to the constructor, replacing the use of kwargs
    - Updated the base class get_params() method to automatically retrieve valid parameters
- Fixed a critical issue where no_label_sample_selection always assigned the default value (#61)
    - Removed redundant table header validation in the ProgressTable class
- Standardized docstrings following the API format (#57)
    - Documentation now focuses exclusively on public methods
    - Added documentation templates for classes, functions, and modules
    - Improved overall consistency and clarity of parameter descriptions

---------

Co-authored-by: Himel Das <151542219+himelds@users.noreply.github.com>
Joao-Paulo-Silva added a commit to AIS-Package/ais-package.github.io that referenced this pull request Apr 26, 2026
Updates the documentation to reflect the changes introduced by the new AISP documentation in [PR #57](AIS-Package/aisp#57).
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 refactor Change without altering behavior.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant