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

Port documentation from Readthedocs to docstrings + Documenter #100

Merged
merged 9 commits into from Aug 30, 2018

Conversation

Evizero
Copy link
Member

@Evizero Evizero commented Aug 29, 2018

I have dreaded this for a long time, but I think 1.0 is a good enough reason to bite in the sour apple.

This moves all the function-signature (and type) documentation into docstrings and ports all the other rst text to markdown.

With a bit of css magick i was even able to hide the ASCII plots and docstring formulas from the online docs of the individual losses. Thus more or less reproducing the old look with the table of figures+formulas

docs


TODO

  • Title page
  • Getting Started
  • Background and Motivation
  • Working with Losses
  • Efficient Sum and Mean
  • Distance-based Losses
  • Margin-based Losses
  • Altering Existing Losses
  • Developer Documentation

@Evizero Evizero changed the title WIP: Port documentation from Readthedocs to docstrings + Documenter Port documentation from Readthedocs to docstrings + Documenter Aug 30, 2018
@Evizero
Copy link
Member Author

Evizero commented Aug 30, 2018

Ok, this should do it.

@Evizero Evizero merged commit c9e4276 into master Aug 30, 2018
@Evizero Evizero deleted the cs/updates branch August 30, 2018 18:14
@Evizero
Copy link
Member Author

Evizero commented Aug 31, 2018

@Evizero Evizero mentioned this pull request Aug 31, 2018
7 tasks
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.

None yet

1 participant