Skip to content

[Update Concept] functions, and complete function arguments#3067

Merged
bobahop merged 87 commits into
mainfrom
bobahop-patch-2
Jun 3, 2022
Merged

[Update Concept] functions, and complete function arguments#3067
bobahop merged 87 commits into
mainfrom
bobahop-patch-2

Conversation

@bobahop

@bobahop bobahop commented May 26, 2022

Copy link
Copy Markdown
Member

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.

@BethanyG BethanyG left a comment

Copy link
Copy Markdown
Member

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.

Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md
Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md Outdated
Comment thread concepts/functions/introduction.md
Comment thread concepts/functions/introduction.md Outdated
@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

BethanyG commented May 26, 2022

Copy link
Copy Markdown
Member

🤦🏽‍♀️ 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 and others added 8 commits May 26, 2022 15:47
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
@bobahop

bobahop commented May 26, 2022

Copy link
Copy Markdown
Member Author

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
Comment thread concepts/function-arguments/about.md Outdated
Comment thread concepts/function-arguments/about.md Outdated
Comment thread concepts/function-arguments/about.md Outdated
Comment thread concepts/function-arguments/about.md Outdated
Comment thread concepts/function-arguments/about.md
Comment thread concepts/function-arguments/about.md Outdated
Comment thread concepts/function-arguments/about.md Outdated
Comment thread concepts/function-arguments/about.md
bobahop and others added 7 commits June 3, 2022 08:31
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
@bobahop

bobahop commented Jun 3, 2022

Copy link
Copy Markdown
Member Author

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

Comment thread concepts/function-arguments/about.md

@BethanyG BethanyG left a comment

Copy link
Copy Markdown
Member

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.

Comment thread concepts/functions/about.md Outdated
Comment thread concepts/functions/about.md Outdated
Comment thread concepts/functions/about.md Outdated
Comment thread concepts/functions/about.md Outdated
Comment thread concepts/functions/about.md Outdated
bobahop and others added 5 commits June 3, 2022 10:40
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
Co-authored-by: BethanyG <BethanyG@users.noreply.github.com>
@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

@BethanyG BethanyG left a comment

Copy link
Copy Markdown
Member

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.

Comment thread concepts/functions/about.md
Comment thread concepts/functions/about.md
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.

3 participants