Giter Club home page Giter Club logo

Comments (6)

treyhunner avatar treyhunner commented on July 17, 2024

I often find the search feature on the Python Documentation website nearly unusable. I think we should link to it but note that searching the documentation might be better done from a search engine (with site:docs.python.org if necessary but even just putting python in your search usually works).

I do think that we should at least link to the relevant documentation for strings, lists, dictionaries, sets, and list comprehensions (and any other important topics). Using help(...) from the command line works but I almost always go straight to the documentation in a web browser (via a DDG/Google search) to find what I'm looking for.

from intro-to-python.

willingc avatar willingc commented on July 17, 2024

@treyhunner I agree about the search feature. The one thing that I like about providing the above link and encouraging people to bookmark it is that the link takes a new developer to a table of contents that essentially hits the high points of the language. When one is new, I think that there are two flavors of information folks seek: 1) searching (i.e. your google suggested route) for a specific function/module, and 2) some context of how all these things fit together as a whole. In 2) when the user sees the table of contents days after leaving this workshop, I hope that the lightbulb moment hits the user: oh wow, I remember talking about this, and this, and that.

I added links in Part 3 to the Python docs section for random and randint. Seems reasonable aid to the presenter if questions come up from audience.

from intro-to-python.

treyhunner avatar treyhunner commented on July 17, 2024

@willingc I agree. Browsing that table of contents could be really helpful for a beginner to get a feel for what's in Python and what they can go to the documentation for.

from intro-to-python.

macro1 avatar macro1 commented on July 17, 2024

Do we have anything like a resource area? We could provide links to the notebooks, related tutorials, learn python the hard way, other related resources. Like a gateway for the online resources for the event.

from intro-to-python.

audreyfeldroy avatar audreyfeldroy commented on July 17, 2024

I was going to cover further resources in Conclusion (formerly Part 5) as well. But if anyone feels ambitious and wants to create a web page with links, please do and I can mention it in Conclusion.

from intro-to-python.

willingc avatar willingc commented on July 17, 2024

Closing this issue since original reminder is addressed in PR #41. 🍪

from intro-to-python.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.