Skip to content

Link to the docs/tutorial/... on library import (inital load) #151

Closed

Description

@patrickleonardy

Task Title

Task: Include a logging to make it easy to find the tutorial page

Task Description

This issue will...

Activity

  1. added a commit that references this issue on Mar 8, 2023
  2. linked a pull request that will close this issue#151 add turorial while importing #152on Mar 8, 2023
  3. added a commit that references this issue on Mar 8, 2023
  4. sandervh14 commented on Mar 9, 2023

    @sandervh14
    Contributor

    This was actually a VERY good idea.
    I'd like to suggest though to use the opportunity to also to link to the documentation, the DFT presentation for details on inner workings and maybe also just the github URL for people that downloaded the library by instruction of someone else.

  5. changed the title [-]include turorial while importing[/-] [+]Link to the docs/tutorial/... on library import (inital load)[/+] on Mar 9, 2023
  6. added this to the 2023-03 milestone on Mar 9, 2023
  7. ZlaTanskY commented on Mar 24, 2023

    @ZlaTanskY
    Contributor

    Why do we add documentation in the code while this is already available in the readme on the github mainpage? (see also this link)

    In my opinion we should separate the place where we put code and where we put documentation, this to avoid clutter whenever we rerun a notebook or a script.

  8. patrickleonardy commented on Apr 3, 2023

    @patrickleonardy
    ContributorAuthor

    It is true that this pops up each time a script is run but in the end it is just a little message under the imports cell. I would not mind as this can be minimized in a notebook . However, I am wondering if this can cause problems when using cobra in production. If this is the case, I suggest that we take it out and include it in help(cobra) or ?cobra. Like this it only shows when the user wants to see it.

  9. patrickleonardy commented on Apr 3, 2023

    @patrickleonardy
    ContributorAuthor

    Sorry did close this issue on accident

  10. ZlaTanskY commented on Apr 4, 2023

    @ZlaTanskY
    Contributor

    I agree that including it in help(cobra) would be a better solution

  11. sandervh14 commented on Apr 6, 2023

    @sandervh14
    Contributor

    Fine for me too!

  12. added a commit that references this issue on Apr 6, 2023
  13. patrickleonardy commented on Apr 6, 2023

    @patrickleonardy
    ContributorAuthor

    okay I'll add it then in the __init__.py file like this it shows up by calling help(cobra). To add the Powerpoint presentation I will convert it to a pdf and upload it to GitHub if this is fine for you.

  14. modified the milestones: 2023-03, on Apr 7, 2023
  15. linked a pull request that will close this issue151 define help function #167on Apr 24, 2023
  16. modified the milestones: , 2023-05 on May 24, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions