Skip to content
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

Update GitHub pages #154

Open
sgpjesus opened this issue Jan 30, 2024 · 1 comment
Open

Update GitHub pages #154

sgpjesus opened this issue Jan 30, 2024 · 1 comment
Labels
Base Regards the base package enhancement New feature or request javascript Pull requests that update Javascript code

Comments

@sgpjesus
Copy link
Collaborator

The current solution for documentation generation for GitHub pages (link here) has some flaws. These are:

  1. New packages, classes, etc. are not included and the process to include them is unclear.
  2. The build of documents is stored in the package, cluttering the docs directory.
  3. The code documentation lacks some aspects (code examples, type hints).
  4. The license is of 2018.
  5. The style is outdated.
  6. There is no landing page.

The current solution is based on sphinx (used in many projects). How do they organize it?
Following the example of sklearn, there is a mix of both generated and explicitly written documentation in the rst files.

  • Example of an explicit documentation page: Tree, rst.
  • Example of a generated documentation page: DecisionTreeClassifier, docstring (No idea how examples notebooks are put in the generated docs).

Sphinx is the basis of documents for many packages (torch is a giant one but super messy, sklearn in between, fairlearn is smaller and pretty clean).

Style is is normaly stored in _static/css or have a dedicated directory for the effect (the case of Sklearn).

Landing pages are a bit weird to see how they are done.

@sgpjesus sgpjesus added enhancement New feature or request javascript Pull requests that update Javascript code labels Jan 30, 2024
@sgpjesus sgpjesus added the Base Regards the base package label Feb 12, 2024
@sgpjesus
Copy link
Collaborator Author

sgpjesus commented Apr 8, 2024

Tasks:

  • Fix the error messages when compiling documentation
  • Add the missing classes (relevant ones) to the documentation
  • Reduce number of pages in the index.rst
  • Make the examples page better
  • Add favicon with a nice Aequitas logo (check if it exists, create if it doesn't)
  • Add versioning
  • (add more)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Base Regards the base package enhancement New feature or request javascript Pull requests that update Javascript code
Projects
None yet
Development

No branches or pull requests

1 participant