Skip to content

Conversation

@bobahop
Copy link
Member

@bobahop bobahop commented May 26, 2022

Updating the functions concept to prepare for the functions concept exercise. This includes completing the function arguments concept, which is currently TODO. Function arguments will be lightly covered in functions, but a link to the function arguments concept will be provided, so something should be in there, I think.

@github-actions

This comment was marked as resolved.

Copy link
Member

@BethanyG BethanyG left a comment

Choose a reason for hiding this comment

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

@bobahop This is great! Thank you so much for revising this and moving it forward. 💙 I've left a bunch of little nits. The only "required" change I'd request is that we use REPL formatting for these small code examples. I'd also add something in here somewhere about Python being an OOP language, and so functions are objects. Beyond that, this looks really good.

@BethanyG BethanyG added the x:rep/large Large amount of reputation label May 26, 2022
Added links for def, argument, parameter, return. Changed links for global and nonlocal, since they no longer pointed to their specific subject. Minor formatting, phrasing and spelling tweaks.
@BethanyG
Copy link
Member

BethanyG commented May 26, 2022

🤦🏽‍♀️ I also forgot .. we probably need to mention scoping/namespacing in here somewhere......

NEVERMIND. I forgot this was the intro. I think this stuff is better in about.md anyways. 😄

@bobahop
Copy link
Member Author

bobahop commented May 26, 2022

Thank you for REPLing the examples. If I had seen the About.md first I might have done that.

@bobahop bobahop self-assigned this Jun 2, 2022
@bobahop
Copy link
Member Author

bobahop commented Jun 3, 2022

@BethanyG , thank you for adding the default arguments section! I conflated them with keyword arguments, but they deserve their own section.

Copy link
Member

@BethanyG BethanyG left a comment

Choose a reason for hiding this comment

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

Ok. Some last suggestions. Beyond these, I think we need a better local -> nonlocal -> global code example progression, but I couldn't suggest one in the interface. But after that, this is good to go.

@bobahop bobahop marked this pull request as ready for review June 3, 2022 15:55
@BethanyG BethanyG self-requested a review June 3, 2022 15:59
Copy link
Member

@BethanyG BethanyG left a comment

Choose a reason for hiding this comment

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

I am going to approve this so we can merge it and work on a cleaner copy. Points we still need to address:

  1. We need to remove the code examples for global and nonlocal and redo them for clarity.
  2. There may be some formatting issues that have crept in. If so, we'll need to address them in a follow-on PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

x:rep/large Large amount of reputation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants