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

Docs #43

Merged
merged 11 commits into from
Nov 8, 2023
Merged

Docs #43

merged 11 commits into from
Nov 8, 2023

Conversation

rtimms
Copy link
Collaborator

@rtimms rtimms commented Aug 31, 2023

Add docs and update README. At the moment, docs must be built locally.

@codecov
Copy link

codecov bot commented Aug 31, 2023

Codecov Report

❗ No coverage uploaded for pull request base (develop@804d758). Click here to learn what that means.
Patch has no changes to coverable lines.

Additional details and impacted files
@@            Coverage Diff             @@
##             develop      #43   +/-   ##
==========================================
  Coverage           ?   96.49%           
==========================================
  Files              ?        9           
  Lines              ?      257           
  Branches           ?        0           
==========================================
  Hits               ?      248           
  Misses             ?        9           
  Partials           ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@codecov-commenter
Copy link

codecov-commenter commented Oct 13, 2023

Codecov Report

All modified lines are covered by tests ✅

❗ No coverage uploaded for pull request base (develop@cd00a67). Click here to learn what that means.

Additional details and impacted files
@@            Coverage Diff             @@
##             develop      #43   +/-   ##
==========================================
  Coverage           ?   97.07%           
==========================================
  Files              ?        9           
  Lines              ?      308           
  Branches           ?        0           
==========================================
  Hits               ?      299           
  Misses             ?        9           
  Partials           ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@rtimms
Copy link
Collaborator Author

rtimms commented Oct 13, 2023

Need to update the URLs in the docs to point to the new repo

Copy link
Collaborator

@martinjrobins martinjrobins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great @rtimms, few suggestions for changes below

docs/Makefile Outdated
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

running this makefile gave me an error:
Makefile:19: *** missing separator. Stop.

Could be that your using spaces instead of tabs
https://stackoverflow.com/questions/920413/make-error-missing-separator

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I actually just copied this from PyBaMM haha, and you get the same error there, but the docs seem to build ok?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yea, docs build ok if you manually call sphinx-build (which is the command in the readme), but the Makefile doesn't work. You could either just delete the Makefile or fix it, up to you.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

probably same over in pybamm if you copied it from there :)

docs/conf.py Outdated Show resolved Hide resolved
docs/source/user_guide/getting_started.md Show resolved Hide resolved
docs/source/user_guide/getting_started.md Outdated Show resolved Hide resolved
Copy link
Collaborator

@martinjrobins martinjrobins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good @rtimms, just the Makefile to deal with, but this is optional (either delete it as unneeded or fix the tabs/spaces thing)

@rtimms rtimms merged commit 9bdb956 into develop Nov 8, 2023
8 checks passed
@rtimms rtimms deleted the docs branch November 8, 2023 11:46
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.

3 participants